-<h2>thread_get_exception_ports</h2>
\r<hr>
\r<p>
\r<strong>Function</strong> - Return a send right to an exception port.
\r<h3>SYNOPSIS</h3>
\r<pre>
\r<strong>kern_return_t thread_get_exception_ports</strong>
\r <strong>(thread_act_t</strong> <var>thread</var>,
\r <strong>exception_mask_t</strong> <var>exception_types</var>,
\r <strong>exception_mask_array_t</strong> <var>old_exception_masks</var>,
\r <strong>old_exception_masks</strong> <var>old_exception_count</var>,
\r <strong>exception_port_array_t</strong> <var>old_exception_ports</var>,
\r <strong>exception_behavior_array_t</strong> <var>old_behaviors</var>,
\r <strong>exception_flavor_array_t</strong> <var>old_flavors</var><strong>);</strong>
\r</pre>
\r<h3>PARAMETERS</h3>
\r<dl>
\r<p>
\r<dt> <var>thread</var>
\r<dd>
\r[in thread send right]
\rThe thread for which to return the exception
\rports.
\r<p>
\r<dt> <var>exception_types</var>
\r<dd>
\r[in scalar]
\rA flag word indicating the types of exceptions for which the
\rexception ports are desired:
\r<dl>
\r<p>
\r<dt> <strong>EXC_MASK_BAD_ACCESS</strong>
\r<dd>
\rCould not access memory.
\r<p>
\r<dt> <strong>EXC_MASK_BAD_INSTRUCTION</strong>
\r<dd>
\rInstruction failed. Illegal or undefined instruction or operand.
\r<p>
\r<dt> <strong>EXC_MASK_ARITHMETIC</strong>
\r<dd>
\rArithmetic exception.
\r<p>
\r<dt> <strong>EXC_MASK_EMULATION</strong>
\r<dd>
\rEmulation instruction. Emulation support instruction
\rencountered.
\r<p>
\r<dt> <strong>EXC_MASK_SOFTWARE</strong>
\r<dd>
\rSoftware generated exception.
\r<p>
\r<dt> <strong>EXC_MASK_BREAKPOINT</strong>
\r<dd>
\rTrace, breakpoint, etc.
\r<p>
\r<dt> <strong>EXC_MASK_SYSCALL</strong>
\r<dd>
\rSystem call requested.
\r<p>
\r<dt> <strong>EXC_MASK_MACH_SYSCALL</strong>
\r<dd>
\rSystem call with a number in the Mach call range requested.
\r</dl>
\r<p>
\r<dt> <var>old_exception_masks</var>
\r<dd>
\r[out array of <var>exception_mask_t</var>]
\rAn array, each element being a mask
\rspecifying for which exception types the corresponding element of the
\rother arrays apply.
\r<p>
\r<dt> <var>old_exception_count</var>
\r<dd>
\r[pointer to in/out scalar]
\rOn input, the maximum size of the array
\rbuffers; on output, the number of returned <exception type mask,
\rexception port, behavior, flavor> sets returned.
\r<p>
\r<dt> <var>old_exception_ports</var>
\r<dd>
\r[out array of exception send rights]
\rThe returned exception ports.
\r<p>
\r<dt> <var>old_behaviors</var>
\r<dd>
\r[out array of <var>exception_behavior_t</var>]
\rThe type of exception message to
\rbe sent. Defined types are:
\r<dl>
\r<p>
\r<dt> <strong>EXCEPTION_DEFAULT</strong>
\r<dd>
\rSend a <strong>catch_exception_raise</strong> message including the thread
\ridentity.
\r<p>
\r<dt> <strong>EXCEPTION_STATE</strong>
\r<dd>
\rSend a <strong>catch_exception_raise_state</strong> message including the
\rthread state.
\r<p>
\r<dt> <strong>EXCEPTION_STATE_IDENTITY</strong>
\r<dd>
\rSend a <strong>catch_exception_raise_state_identity</strong> message
\rincluding the thread identity and state.
\r</dl>
\r<p>
\r<dt> <var>old_flavors</var>
\r<dd>
\r[out array of <var>thread_state_flavor_t</var>]
\rThe type of state to be sent with
\rthe exception message. These types are defined in \*L<mach/thread_states.h>\*O.
\r</dl>
\r<h3>DESCRIPTION</h3>
\r<p>
\rThe <strong>thread_get_exception_ports</strong> function returns send
\rrights for a specified
\rset of exception ports belonging to <var>thread</var>. The call returns
\ra set of quadruples
\r<exception type mask, exception port, behavior, flavor> for each unique set of
\r<exception port, behavior, flavor> in effect for the thread where
\rthe exception
\rtype mask indicates for which exception types the other values apply.
\r<h3>RETURN VALUES</h3>
\r<dl>
\r<p>
\r<dt> <strong>KERN_EXCEPTION_PROTECTED</strong>
\r<dd>
\rOne of the requested exception ports is protected and cannot be returned.
\r</dl>
\r<h3>RELATED INFORMATION</h3>
\r<p>
\rFunctions:
\r<a href="mach_thread_self.html"><strong>mach_thread_self</strong></a>,
\r<a href="task_get_exception_ports.html"><strong>task_get_exception_ports</strong></a>,
\r<a href="task_set_exception_ports.html"><strong>task_set_exception_ports</strong></a>,
\r<a href="task_swap_exception_ports.html"><strong>task_swap_exception_ports</strong></a>,
\r<a href="thread_create.html"><strong>thread_create</strong></a>,
\r<a href="thread_set_exception_ports.html"><strong>thread_set_exception_ports</strong></a>,
\r<a href="TS_exception_ports.html"><strong>thread_swap_exception_ports</strong></a>,
\r<a href="catch_exception_raise.html"><strong>catch_exception_raise</strong></a>.
\r\ No newline at end of file
+<h2>thread_get_exception_ports</h2>
+<hr>
+<p>
+<strong>Function</strong> - Return a send right to an exception port.
+<h3>SYNOPSIS</h3>
+<pre>
+<strong>kern_return_t thread_get_exception_ports</strong>
+ <strong>(thread_act_t</strong> <var>thread</var>,
+ <strong>exception_mask_t</strong> <var>exception_types</var>,
+ <strong>exception_mask_array_t</strong> <var>old_exception_masks</var>,
+ <strong>old_exception_masks</strong> <var>old_exception_count</var>,
+ <strong>exception_port_array_t</strong> <var>old_exception_ports</var>,
+ <strong>exception_behavior_array_t</strong> <var>old_behaviors</var>,
+ <strong>exception_flavor_array_t</strong> <var>old_flavors</var><strong>);</strong>
+</pre>
+<h3>PARAMETERS</h3>
+<dl>
+<p>
+<dt> <var>thread</var>
+<dd>
+[in thread send right]
+The thread for which to return the exception
+ports.
+<p>
+<dt> <var>exception_types</var>
+<dd>
+[in scalar]
+A flag word indicating the types of exceptions for which the
+exception ports are desired:
+<dl>
+<p>
+<dt> <strong>EXC_MASK_BAD_ACCESS</strong>
+<dd>
+Could not access memory.
+<p>
+<dt> <strong>EXC_MASK_BAD_INSTRUCTION</strong>
+<dd>
+Instruction failed. Illegal or undefined instruction or operand.
+<p>
+<dt> <strong>EXC_MASK_ARITHMETIC</strong>
+<dd>
+Arithmetic exception.
+<p>
+<dt> <strong>EXC_MASK_EMULATION</strong>
+<dd>
+Emulation instruction. Emulation support instruction
+encountered.
+<p>
+<dt> <strong>EXC_MASK_SOFTWARE</strong>
+<dd>
+Software generated exception.
+<p>
+<dt> <strong>EXC_MASK_BREAKPOINT</strong>
+<dd>
+Trace, breakpoint, etc.
+<p>
+<dt> <strong>EXC_MASK_SYSCALL</strong>
+<dd>
+System call requested.
+<p>
+<dt> <strong>EXC_MASK_MACH_SYSCALL</strong>
+<dd>
+System call with a number in the Mach call range requested.
+</dl>
+<p>
+<dt> <var>old_exception_masks</var>
+<dd>
+[out array of <var>exception_mask_t</var>]
+An array, each element being a mask
+specifying for which exception types the corresponding element of the
+other arrays apply.
+<p>
+<dt> <var>old_exception_count</var>
+<dd>
+[pointer to in/out scalar]
+On input, the maximum size of the array
+buffers; on output, the number of returned <exception type mask,
+exception port, behavior, flavor> sets returned.
+<p>
+<dt> <var>old_exception_ports</var>
+<dd>
+[out array of exception send rights]
+The returned exception ports.
+<p>
+<dt> <var>old_behaviors</var>
+<dd>
+[out array of <var>exception_behavior_t</var>]
+The type of exception message to
+be sent. Defined types are:
+<dl>
+<p>
+<dt> <strong>EXCEPTION_DEFAULT</strong>
+<dd>
+Send a <strong>catch_exception_raise</strong> message including the thread
+identity.
+<p>
+<dt> <strong>EXCEPTION_STATE</strong>
+<dd>
+Send a <strong>catch_exception_raise_state</strong> message including the
+thread state.
+<p>
+<dt> <strong>EXCEPTION_STATE_IDENTITY</strong>
+<dd>
+Send a <strong>catch_exception_raise_state_identity</strong> message
+including the thread identity and state.
+</dl>
+<p>
+<dt> <var>old_flavors</var>
+<dd>
+[out array of <var>thread_state_flavor_t</var>]
+The type of state to be sent with
+the exception message. These types are defined in \*L<mach/thread_states.h>\*O.
+</dl>
+<h3>DESCRIPTION</h3>
+<p>
+The <strong>thread_get_exception_ports</strong> function returns send
+rights for a specified
+set of exception ports belonging to <var>thread</var>. The call returns
+a set of quadruples
+<exception type mask, exception port, behavior, flavor> for each unique set of
+<exception port, behavior, flavor> in effect for the thread where
+the exception
+type mask indicates for which exception types the other values apply.
+<h3>RETURN VALUES</h3>
+<dl>
+<p>
+<dt> <strong>KERN_EXCEPTION_PROTECTED</strong>
+<dd>
+One of the requested exception ports is protected and cannot be returned.
+</dl>
+<h3>RELATED INFORMATION</h3>
+<p>
+Functions:
+<a href="mach_thread_self.html"><strong>mach_thread_self</strong></a>,
+<a href="task_get_exception_ports.html"><strong>task_get_exception_ports</strong></a>,
+<a href="task_set_exception_ports.html"><strong>task_set_exception_ports</strong></a>,
+<a href="task_swap_exception_ports.html"><strong>task_swap_exception_ports</strong></a>,
+<a href="thread_create.html"><strong>thread_create</strong></a>,
+<a href="thread_set_exception_ports.html"><strong>thread_set_exception_ports</strong></a>,
+<a href="TS_exception_ports.html"><strong>thread_swap_exception_ports</strong></a>,
+<a href="catch_exception_raise.html"><strong>catch_exception_raise</strong></a>.
projects / apple / xnu.git / blobdiff