[apple/xnu.git] / osfmk / man / task_set_port_space.html

<h2>task_set_port_space</h2>\r<hr>\r<p>\r<strong>Function</strong> - Set the size of the target  task's port name space table.\r<h3>SYNOPSIS</h3>\r<pre>\r<strong>kern_return_t   task_set_port_space</strong>\r                <strong>(task_t</strong>                                    <var>task</var>,\r                 <strong>int</strong>                              <var>table_entries</var><strong>);</strong>\r</pre>\r<h3>PARAMETERS</h3>\r<dl>\r<p>\r<dt> <var>task</var>\r<dd>\r[in send right] The port referencing the task whose port name space is\rto be set.\r<p>\r<dt> <var>table_entries</var>\r<dd>\r[in scalar] The number of entries in the port name space table.\r</dl>\r<h3>DESCRIPTION</h3>\r<p>\rThe <strong>task_set_port_space</strong> function preallocates the specified number of\rentries in the specified task's IPC name space.\r<h3>RETURN VALUES</h3>\r<dl>\r<p>\r<dt> <strong>KERN_NO_SPACE</strong>\r<dd>\rThe requested table size exceeds the maximum allowable table size.\r</dl>\r<h3>RELATED INFORMATION</h3>\r<p>\rFunctions:\r<a href="mach_port_allocate.html"><strong>mach_port_allocate</strong></a>.\r