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>.