osfmk/man/thread_set_special_port.html

   1 <h2>thread_set_special_port</h2>
<hr>
<p>
<strong>Function</strong> - Set caller-specified special port belonging to the target thread.
<h3>SYNOPSIS</h3>
<pre>
<strong>kern_return_t   thread_set_special_port</strong>
                <strong>(thread_act_t</strong>                            <var>thread</var>,
                 <strong>int</strong>                                 <var>which_port</var>,
                 <strong>mach_port_t</strong>                       <var>special_port</var><strong>);</strong>
</pre>

<h4>Macro form:</h4>
<pre>
<strong>kern_return_t   thread_set_kernel_port</strong>
                <strong>(thread_act_t</strong>                            <var>thread</var>,
                 <strong>mach_port_t</strong>                       <var>special_port</var><strong>);</strong>
</pre>
<h3>PARAMETERS</h3>
<dl>
<p>
<dt> <var>thread</var> 
<dd>
[in thread send right]
The thread for which to set the port.
<p>
<dt> <var>which_port</var> 
<dd>
[in scalar]
The special port to be set.  Valid values are:
<dl>
<p>
<dt> <strong>THREAD_KERNEL_PORT</strong>
<dd>
[thread-self port] The thread's kernel port.  Used by the kernel 
to receive messages from the thread.  This is the port returned 
by <strong>mach_thread_self</strong>.
</dl>
<p>
<dt> <var>special_port</var> 
<dd>
[in thread-special send right]
The value for the port.
</dl>
<h3>DESCRIPTION</h3>
<p>
The <strong>thread_set_special_port</strong> function sets a special
port belonging to <var>thread</var>.
<h3>RETURN VALUES</h3>
<p>
Only generic errors apply.
<h3>RELATED INFORMATION</h3>
<p>
Functions:
<a href="mach_thread_self.html"><strong>mach_thread_self</strong></a>,
<a href="task_get_special_port.html"><strong>task_get_special_port</strong></a>,
<a href="task_set_special_port.html"><strong>task_set_special_port</strong></a>,
<a href="thread_create.html"><strong>thread_create</strong></a>,
<a href="thread_get_special_port.html"><strong>thread_get_special_port</strong></a>.