libs/test/doc/html/boost/execution_monitor.html

   1 <html>
   2 <head>
   3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   4 <title>Class execution_monitor</title>
   5 <link rel="stylesheet" href="../boostbook.css" type="text/css">
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   7 <link rel="home" href="../index.html" title="Boost.Test">
   8 <link rel="up" href="../header/boost/test/execution_monitor_hpp.html" title="Header &lt;boost/test/execution_monitor.hpp&gt;">
   9 <link rel="prev" href="execution_exception/error_code.html" title="Type error_code">
  10 <link rel="next" href="system_error.html" title="Class system_error">
  11 </head>
  12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13 <table cellpadding="2" width="100%"><tr>
  14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
  15 <td align="center"><a href="../../../../../index.html">Home</a></td>
  16 <td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td>
  17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19 <td align="center"><a href="../../../../../more/index.htm">More</a></td>
  20 </tr></table>
  21 <hr>
  22 <div class="spirit-nav">
  23 <a accesskey="p" href="execution_exception/error_code.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../header/boost/test/execution_monitor_hpp.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="system_error.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  24 </div>
  25 <div class="refentry">
  26 <a name="boost.execution_monitor"></a><div class="titlepage"></div>
  27 <div class="refnamediv">
  28 <h2><span class="refentrytitle">Class execution_monitor</span></h2>
  29 <p>boost::execution_monitor &#8212; Function execution monitor. </p>
  30 </div>
  31 <h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
  32 <div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"><span class="comment">// In header: &lt;<a class="link" href="../header/boost/test/execution_monitor_hpp.html" title="Header &lt;boost/test/execution_monitor.hpp&gt;">boost/test/execution_monitor.hpp</a>&gt;
  33
  34 </span>
  35 <span class="keyword">class</span> <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> <span class="special">{</span>
  36 <span class="keyword">public</span><span class="special">:</span>
  37   <span class="comment">// <a class="link" href="execution_monitor.html#boost.execution_monitorconstruct-copy-destruct">construct/copy/destruct</a></span>
  38   <a class="link" href="execution_monitor.html#idm46279113807824-bb"><span class="identifier">execution_monitor</span></a><span class="special">(</span><span class="special">)</span><span class="special">;</span>
  39
  40   <span class="comment">// <a class="link" href="execution_monitor.html#idm46279113835936-bb">public member functions</a></span>
  41   <span class="keyword">int</span> <a class="link" href="execution_monitor.html#idm46279113835376-bb"><span class="identifier">execute</span></a><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">int</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  42   <span class="keyword">void</span> <a class="link" href="execution_monitor.html#idm46279113828608-bb"><span class="identifier">vexecute</span></a><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">void</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  43   <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> ExceptionType<span class="special">,</span> <span class="keyword">typename</span> ExceptionTranslator<span class="special">&gt;</span>
  44     <span class="keyword">void</span> <a class="link" href="execution_monitor.html#idm46279113824496-bb"><span class="identifier">register_exception_translator</span></a><span class="special">(</span><span class="identifier">ExceptionTranslator</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">,</span>
  45                                        <span class="identifier">const_string</span> <span class="special">=</span> <span class="identifier">const_string</span><span class="special">(</span><span class="special">)</span><span class="special">,</span>
  46                                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">type</span><span class="special">&lt;</span> <span class="identifier">ExceptionType</span> <span class="special">&gt;</span> <span class="special">*</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="special">;</span>
  47   <span class="keyword">void</span> <a class="link" href="execution_monitor.html#idm46279113814288-bb"><span class="identifier">erase_exception_translator</span></a><span class="special">(</span><span class="identifier">const_string</span><span class="special">)</span><span class="special">;</span>
  48   <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> ExceptionType<span class="special">&gt;</span>
  49     <span class="keyword">void</span> <a class="link" href="execution_monitor.html#idm46279113811504-bb"><span class="identifier">erase_exception_translator</span></a><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">type</span><span class="special">&lt;</span> <span class="identifier">ExceptionType</span> <span class="special">&gt;</span> <span class="special">*</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="special">;</span>
  50
  51   <span class="comment">// <a class="link" href="execution_monitor.html#idm46279113807200-bb">private member functions</a></span>
  52   <span class="keyword">int</span> <a class="link" href="execution_monitor.html#idm46279113806624-bb"><span class="identifier">catch_signals</span></a><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">int</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span><span class="special">)</span><span class="special">;</span>
  53
  54   <span class="comment">// <a class="link" href="execution_monitor.html#boost.execution_monitorpublic-data-members">public data members</a></span>
  55   <span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a class="link" href="execution_monitor.html#boost.execution_monitor.p_catch_system_errors"><span class="identifier">p_catch_system_errors</span></a><span class="special">;</span>  <span class="comment">// Should monitor catch system errors. </span>
  56   <span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a class="link" href="execution_monitor.html#boost.execution_monitor.p_auto_start_dbg"><span class="identifier">p_auto_start_dbg</span></a><span class="special">;</span>  <span class="comment">// Should monitor try to attach debugger in case of caught system error. </span>
  57   <span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">unsigned</span> <span class="keyword">long</span> <span class="keyword">int</span> <span class="special">&gt;</span> <a class="link" href="execution_monitor.html#boost.execution_monitor.p_timeout"><span class="identifier">p_timeout</span></a><span class="special">;</span>  <span class="comment">// Specifies the seconds that elapse before a timer_error occurs. </span>
  58   <span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a class="link" href="execution_monitor.html#boost.execution_monitor.p_use_alt_stack"><span class="identifier">p_use_alt_stack</span></a><span class="special">;</span>  <span class="comment">// Should monitor use alternative stack for the signal catching. </span>
  59   <span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">unsigned</span> <span class="special">&gt;</span> <a class="link" href="execution_monitor.html#boost.execution_monitor.p_detect_fp_exceptions"><span class="identifier">p_detect_fp_exceptions</span></a><span class="special">;</span>  <span class="comment">// Should monitor try to detect hardware floating point exceptions (!= 0), and which specific exception to catch. </span>
  60 <span class="special">}</span><span class="special">;</span></pre></div>
  61 <div class="refsect1">
  62 <a name="idm45313890311600"></a><h2>Description</h2>
  63 <p>This class is used to uniformly detect and report an occurrence of several types of signals and exceptions, reducing various errors to a uniform <a class="link" href="execution_exception.html" title="Class execution_exception">execution_exception</a> that is returned to a caller.</p>
  64 <p>The executiom_monitor behavior can be customized through a set of public parameters (properties) associated with the <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> instance. All parameters are implemented as public unit_test::readwrite_property data members of the class <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a>. </p>
  65 <div class="refsect2">
  66 <a name="idm45313890308416"></a><h3>
  67 <a name="boost.execution_monitorconstruct-copy-destruct"></a><code class="computeroutput">execution_monitor</code>
  68         public
  69        construct/copy/destruct</h3>
  70 <div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
  71 <pre class="literallayout"><a name="idm46279113807824-bb"></a><span class="identifier">execution_monitor</span><span class="special">(</span><span class="special">)</span><span class="special">;</span></pre>Default constructor initializes all execution monitor properties. </li></ol></div>
  72 </div>
  73 <div class="refsect2">
  74 <a name="idm45313890303136"></a><h3>
  75 <a name="idm46279113835936-bb"></a><code class="computeroutput">execution_monitor</code> public member functions</h3>
  76 <div class="orderedlist"><ol class="orderedlist" type="1">
  77 <li class="listitem">
  78 <pre class="literallayout"><span class="keyword">int</span> <a name="idm46279113835376-bb"></a><span class="identifier">execute</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">int</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> F<span class="special">)</span><span class="special">;</span></pre>Execution monitor entry point for functions returning integer value. <p>This method executes supplied function F inside a try/catch block and also may include other unspecified platform dependent error detection code.</p>
  79 <p>This method throws an <code class="computeroutput"><a class="link" href="execution_exception.html" title="Class execution_exception">execution_exception</a></code> on an uncaught C++ exception, a hardware or software signal, trap, or other user exception.</p>
  80 <div class="note"><table border="0" summary="Note">
  81 <tr>
  82 <td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
  83 <th align="left">Note</th>
  84 </tr>
  85 <tr><td align="left" valign="top"><p>execute() doesn't consider it an error for F to return a non-zero value. </p></td></tr>
  86 </table></div>
  87 <p>
  88
  89
  90 </p>
  91 <p><span class="bold"><strong>See Also:</strong></span></p>
  92 <p>vexecute </p>
  93 <p>
  94 </p>
  95 <p>
  96 </p>
  97 <div class="variablelist"><table border="0" class="variablelist compact">
  98 <colgroup>
  99 <col align="left" valign="top">
 100 <col>
 101 </colgroup>
 102 <tbody>
 103 <tr>
 104 <td><p><span class="term">Parameters:</span></p></td>
 105 <td><div class="variablelist"><table border="0" class="variablelist compact">
 106 <colgroup>
 107 <col align="left" valign="top">
 108 <col>
 109 </colgroup>
 110 <tbody><tr>
 111 <td><p><span class="term"><code class="computeroutput">F</code></span></p></td>
 112 <td><p>Function to monitor </p></td>
 113 </tr></tbody>
 114 </table></div></td>
 115 </tr>
 116 <tr>
 117 <td><p><span class="term">Returns:</span></p></td>
 118 <td><p>value returned by function call F(). </p></td>
 119 </tr>
 120 </tbody>
 121 </table></div>
 122 </li>
 123 <li class="listitem">
 124 <pre class="literallayout"><span class="keyword">void</span> <a name="idm46279113828608-bb"></a><span class="identifier">vexecute</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">void</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> F<span class="special">)</span><span class="special">;</span></pre>Execution monitor entry point for functions returning void. <p>This method is semantically identical to execution_monitor::execute, but des't produce any result code.
 125 </p>
 126 <p><span class="bold"><strong>See Also:</strong></span></p>
 127 <p>execute </p>
 128 <p>
 129 </p>
 130 <p>
 131 </p>
 132 <div class="variablelist"><table border="0" class="variablelist compact">
 133 <colgroup>
 134 <col align="left" valign="top">
 135 <col>
 136 </colgroup>
 137 <tbody><tr>
 138 <td><p><span class="term">Parameters:</span></p></td>
 139 <td><div class="variablelist"><table border="0" class="variablelist compact">
 140 <colgroup>
 141 <col align="left" valign="top">
 142 <col>
 143 </colgroup>
 144 <tbody><tr>
 145 <td><p><span class="term"><code class="computeroutput">F</code></span></p></td>
 146 <td><p>Function to monitor </p></td>
 147 </tr></tbody>
 148 </table></div></td>
 149 </tr></tbody>
 150 </table></div>
 151 </li>
 152 <li class="listitem">
 153 <pre class="literallayout"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> ExceptionType<span class="special">,</span> <span class="keyword">typename</span> ExceptionTranslator<span class="special">&gt;</span>
 154   <span class="keyword">void</span> <a name="idm46279113824496-bb"></a><span class="identifier">register_exception_translator</span><span class="special">(</span><span class="identifier">ExceptionTranslator</span> <span class="keyword">const</span> <span class="special">&amp;</span> tr<span class="special">,</span>
 155                                      <span class="identifier">const_string</span> tag <span class="special">=</span> <span class="identifier">const_string</span><span class="special">(</span><span class="special">)</span><span class="special">,</span>
 156                                      <span class="identifier">boost</span><span class="special">::</span><span class="identifier">type</span><span class="special">&lt;</span> <span class="identifier">ExceptionType</span> <span class="special">&gt;</span> <span class="special">*</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="special">;</span></pre>Registers custom (user supplied) exception translator. <p>This method template registers a translator for an exception type specified as a first template argument. For example </p>
 157 <pre class="programlisting"><span class="keyword">void</span> <span class="identifier">myExceptTr</span><span class="special">(</span> <span class="identifier">MyException</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">ex</span> <span class="special">)</span> <span class="special">{</span> <span class="comment">/*do something with the exception here*/</span><span class="special">}</span>
 158 <span class="identifier">em</span><span class="special">.</span><span class="identifier">register_exception_translator</span><span class="special">&lt;</span><span class="identifier">MyException</span><span class="special">&gt;</span><span class="special">(</span> <span class="identifier">myExceptTr</span> <span class="special">)</span><span class="special">;</span>
 159 </pre>
 160 <p> The translator should be any unary function/functor object which accepts MyException const&amp;. This can be free standing function or bound class method. The second argument is an optional string tag you can associate with this translator routine. The only reason to specify the tag is if you plan to erase the translator eventually. This can be useful in scenario when you reuse the same <code class="computeroutput"><a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a></code> instance to monitor different routines and need to register a translator specific to the routine being monitored. While it is possible to erase the translator based on an exception type it was registered for, tag string provides simpler way of doing this.
 161
 162 </p>
 163 <div class="variablelist"><table border="0" class="variablelist compact">
 164 <colgroup>
 165 <col align="left" valign="top">
 166 <col>
 167 </colgroup>
 168 <tbody>
 169 <tr>
 170 <td><p><span class="term">Parameters:</span></p></td>
 171 <td><div class="variablelist"><table border="0" class="variablelist compact">
 172 <colgroup>
 173 <col align="left" valign="top">
 174 <col>
 175 </colgroup>
 176 <tbody>
 177 <tr>
 178 <td><p><span class="term"><code class="computeroutput">tag</code></span></p></td>
 179 <td><p>tag associated with this translator </p></td>
 180 </tr>
 181 <tr>
 182 <td><p><span class="term"><code class="computeroutput">tr</code></span></p></td>
 183 <td><p>translator function object with the signature <span class="emphasis"><em> void (ExceptionType const&amp;)</em></span> </p></td>
 184 </tr>
 185 </tbody>
 186 </table></div></td>
 187 </tr>
 188 <tr>
 189 <td><p><span class="term">Template Parameters:</span></p></td>
 190 <td><div class="variablelist"><table border="0" class="variablelist compact">
 191 <colgroup>
 192 <col align="left" valign="top">
 193 <col>
 194 </colgroup>
 195 <tbody>
 196 <tr>
 197 <td><p><span class="term"><code class="computeroutput">ExceptionTranslator</code></span></p></td>
 198 <td><p>type of the translator we register for this exception </p></td>
 199 </tr>
 200 <tr>
 201 <td><p><span class="term"><code class="computeroutput">ExceptionType</code></span></p></td>
 202 <td><p>type of the exception we register a translator for </p></td>
 203 </tr>
 204 </tbody>
 205 </table></div></td>
 206 </tr>
 207 </tbody>
 208 </table></div>
 209 </li>
 210 <li class="listitem">
 211 <pre class="literallayout"><span class="keyword">void</span> <a name="idm46279113814288-bb"></a><span class="identifier">erase_exception_translator</span><span class="special">(</span><span class="identifier">const_string</span> tag<span class="special">)</span><span class="special">;</span></pre>Erases custom exception translator based on a tag. <p>Use the same tag as the one used during translator registration
 212 </p>
 213 <div class="variablelist"><table border="0" class="variablelist compact">
 214 <colgroup>
 215 <col align="left" valign="top">
 216 <col>
 217 </colgroup>
 218 <tbody><tr>
 219 <td><p><span class="term">Parameters:</span></p></td>
 220 <td><div class="variablelist"><table border="0" class="variablelist compact">
 221 <colgroup>
 222 <col align="left" valign="top">
 223 <col>
 224 </colgroup>
 225 <tbody><tr>
 226 <td><p><span class="term"><code class="computeroutput">tag</code></span></p></td>
 227 <td><p>tag associated with translator you wants to erase </p></td>
 228 </tr></tbody>
 229 </table></div></td>
 230 </tr></tbody>
 231 </table></div>
 232 </li>
 233 <li class="listitem">
 234 <pre class="literallayout"><span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> ExceptionType<span class="special">&gt;</span>
 235   <span class="keyword">void</span> <a name="idm46279113811504-bb"></a><span class="identifier">erase_exception_translator</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">type</span><span class="special">&lt;</span> <span class="identifier">ExceptionType</span> <span class="special">&gt;</span> <span class="special">*</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span><span class="special">;</span></pre>Erases custom exception translator based on an exception type. <p>tparam ExceptionType Exception type for which you want to erase the translator </p>
 236 </li>
 237 </ol></div>
 238 </div>
 239 <div class="refsect2">
 240 <a name="idm45313890210784"></a><h3>
 241 <a name="idm46279113807200-bb"></a><code class="computeroutput">execution_monitor</code> private member functions</h3>
 242 <div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="literallayout"><span class="keyword">int</span> <a name="idm46279113806624-bb"></a><span class="identifier">catch_signals</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">function</span><span class="special">&lt;</span> <span class="keyword">int</span><span class="special">(</span><span class="special">)</span><span class="special">&gt;</span> <span class="keyword">const</span> <span class="special">&amp;</span> F<span class="special">)</span><span class="special">;</span></pre></li></ol></div>
 243 </div>
 244 <div class="refsect2">
 245 <a name="idm45313890199616"></a><h3>
 246 <a name="boost.execution_monitorpublic-data-members"></a><code class="computeroutput">execution_monitor</code>
 247         public
 248        public data members</h3>
 249 <div class="orderedlist"><ol class="orderedlist" type="1">
 250 <li class="listitem">
 251 <pre class="literallayout"><span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a name="boost.execution_monitor.p_catch_system_errors"></a><span class="identifier">p_catch_system_errors</span><span class="special">;</span></pre>
 252 <p>The <span class="emphasis"><em>p_catch_system_errors</em></span> property is a boolean flag (default value is true) specifying whether or not <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> should trap system errors/system level exceptions/signals, which would cause program to crash in a regular case (without <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a>). Set this property to false, for example, if you wish to force coredump file creation. The Unit Test Framework provides a runtime parameter <code class="computeroutput">--catch_system_errors=yes</code> to alter the behavior in monitored test cases. </p>
 253 </li>
 254 <li class="listitem">
 255 <pre class="literallayout"><span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a name="boost.execution_monitor.p_auto_start_dbg"></a><span class="identifier">p_auto_start_dbg</span><span class="special">;</span></pre>
 256 <p>The <span class="emphasis"><em>p_auto_start_dbg</em></span> property is a boolean flag (default value is false) specifying whether or not <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> should try to attach debugger in case system error is caught. </p>
 257 </li>
 258 <li class="listitem">
 259 <pre class="literallayout"><span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">unsigned</span> <span class="keyword">long</span> <span class="keyword">int</span> <span class="special">&gt;</span> <a name="boost.execution_monitor.p_timeout"></a><span class="identifier">p_timeout</span><span class="special">;</span></pre>
 260 <p>The <span class="emphasis"><em>p_timeout</em></span> property is an integer timeout (in microseconds) for monitored function execution. Use this parameter to monitor code with possible deadlocks or infinite loops. This feature is only available for some operating systems (not yet Microsoft Windows). </p>
 261 </li>
 262 <li class="listitem">
 263 <pre class="literallayout"><span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">bool</span> <span class="special">&gt;</span> <a name="boost.execution_monitor.p_use_alt_stack"></a><span class="identifier">p_use_alt_stack</span><span class="special">;</span></pre>
 264 <p>The <span class="emphasis"><em>p_use_alt_stack</em></span> property is a boolean flag (default value is false) specifying whether or not <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> should use an alternative stack for the sigaction based signal catching. When enabled the signals are delivered to the <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> on a stack different from current execution stack, which is safer in case if it is corrupted by monitored function. For more details on alternative stack handling see appropriate manuals. </p>
 265 </li>
 266 <li class="listitem">
 267 <pre class="literallayout"><span class="identifier">unit_test</span><span class="special">::</span><span class="identifier">readwrite_property</span><span class="special">&lt;</span> <span class="keyword">unsigned</span> <span class="special">&gt;</span> <a name="boost.execution_monitor.p_detect_fp_exceptions"></a><span class="identifier">p_detect_fp_exceptions</span><span class="special">;</span></pre>
 268 <p>The <span class="emphasis"><em>p_detect_fp_exceptions</em></span> property is a boolean flag (default value is false) specifying whether or not <a class="link" href="execution_monitor.html" title="Class execution_monitor">execution_monitor</a> should install hardware traps for the floating point exception on platforms where it's supported. </p>
 269 </li>
 270 </ol></div>
 271 </div>
 272 </div>
 273 </div>
 274 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
 275 <td align="left"></td>
 276 <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
 277       contributors<p>
 278         Distributed under the Boost Software License, Version 1.0. (See accompanying
 279         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
 280       </p>
 281 </div></td>
 282 </tr></table>
 283 <hr>
 284 <div class="spirit-nav">
 285 <a accesskey="p" href="execution_exception/error_code.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../header/boost/test/execution_monitor_hpp.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="system_error.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
 286 </div>
 287 </body>
 288 </html>