xref: /xnu-8796.141.3/osfmk/man/task_set_port_space.html (revision 1b191cb58250d0705d8a51287127505aa4bc0789)
1*1b191cb5SApple OSS Distributions<h2>task_set_port_space</h2>
2*1b191cb5SApple OSS Distributions<hr>
3*1b191cb5SApple OSS Distributions<p>
4*1b191cb5SApple OSS Distributions<strong>Function</strong> - Set the size of the target  task's port name space table.
5*1b191cb5SApple OSS Distributions<h3>SYNOPSIS</h3>
6*1b191cb5SApple OSS Distributions<pre>
7*1b191cb5SApple OSS Distributions<strong>kern_return_t   task_set_port_space</strong>
8*1b191cb5SApple OSS Distributions                <strong>(task_t</strong>                                    <var>task</var>,
9*1b191cb5SApple OSS Distributions                 <strong>int</strong>                              <var>table_entries</var><strong>);</strong>
10*1b191cb5SApple OSS Distributions</pre>
11*1b191cb5SApple OSS Distributions<h3>PARAMETERS</h3>
12*1b191cb5SApple OSS Distributions<dl>
13*1b191cb5SApple OSS Distributions<p>
14*1b191cb5SApple OSS Distributions<dt> <var>task</var>
15*1b191cb5SApple OSS Distributions<dd>
16*1b191cb5SApple OSS Distributions[in send right] The port referencing the task whose port name space is
17*1b191cb5SApple OSS Distributionsto be set.
18*1b191cb5SApple OSS Distributions<p>
19*1b191cb5SApple OSS Distributions<dt> <var>table_entries</var>
20*1b191cb5SApple OSS Distributions<dd>
21*1b191cb5SApple OSS Distributions[in scalar] The number of entries in the port name space table.
22*1b191cb5SApple OSS Distributions</dl>
23*1b191cb5SApple OSS Distributions<h3>DESCRIPTION</h3>
24*1b191cb5SApple OSS Distributions<p>
25*1b191cb5SApple OSS DistributionsThe <strong>task_set_port_space</strong> function preallocates the specified number of
26*1b191cb5SApple OSS Distributionsentries in the specified task's IPC name space.
27*1b191cb5SApple OSS Distributions<h3>RETURN VALUES</h3>
28*1b191cb5SApple OSS Distributions<dl>
29*1b191cb5SApple OSS Distributions<p>
30*1b191cb5SApple OSS Distributions<dt> <strong>KERN_NO_SPACE</strong>
31*1b191cb5SApple OSS Distributions<dd>
32*1b191cb5SApple OSS DistributionsThe requested table size exceeds the maximum allowable table size.
33*1b191cb5SApple OSS Distributions</dl>
34*1b191cb5SApple OSS Distributions<h3>RELATED INFORMATION</h3>
35*1b191cb5SApple OSS Distributions<p>
36*1b191cb5SApple OSS DistributionsFunctions:
37*1b191cb5SApple OSS Distributions<a href="mach_port_allocate.html"><strong>mach_port_allocate</strong></a>.
38