1<h2>mach_port_names</h2> 2<hr> 3<p> 4<strong>Function</strong> - Return information about a task's port name space. 5<h3>SYNOPSIS</h3> 6<pre> 7<strong>kern_return_t mach_port_names</strong> 8 <strong>(ipc_space_t</strong> <var>task</var>, 9 <strong>mach_port_name_array_t</strong> <var>*names</var>, 10 <strong>mach_msg_type_number_t</strong> <var>*namesCnt</var>, 11 <strong>mach_port_type_array_</strong> <var>*types</var>, 12 <strong>mach_msg_type_number_t</strong> <var>*typesCnt</var><strong>);</strong> 13</pre> 14<h3>PARAMETERS</h3> 15<dl> 16<p> 17<dt> <var>task</var> 18<dd> 19[in task send right] 20The task whose port name space is queried. 21<p> 22<dt> <var>names</var> 23<dd> 24[out pointer to dynamic array of <var>mach_port_name_t</var>] 25The names of the 26ports, port sets, and dead names in the task's port name space, in no 27particular order. 28<p> 29<dt> <var>namesCnt</var> 30<dd> 31[out scalar] 32The number of names returned. 33<p> 34<dt> <var>types</var> 35<dd> 36[out pointer to dynamic array of <var>mach_port_type_t</var>] 37The type of each 38corresponding name. Indicates what kind of rights the task holds with 39that name. 40<p> 41<dt> <var>typesCnt</var> 42<dd> 43[out scalar] 44The number of types returned. 45</dl> 46<h3>DESCRIPTION</h3> 47<p> 48The <strong>mach_port_names</strong> returns information about <var>task</var>'s 49port name space. It 50returns task's currently active names, which represent some port, 51port set, or dead 52name right. For each name, it also returns what type of rights 53<var>task</var> holds (the 54same information returned by <strong>mach_port_type</strong>). 55<p> 56Note that when a call to <strong>mach_port_names</strong> returns, the 57number of entries in the two output arrays (<var>names</var> and <var>types</var>) 58are equal (<var>namesCnt</var> equals <var>typesCnt</var>). The fact that this 59interface returns two separate counts is an artifact of the Mach Interface Generator. 60<h3>NOTES</h3> 61<p> 62This interface is machine word length specific because of the port name 63parameter and the returned port names. 64<h3>RETURN VALUES</h3> 65<p> 66Only generic errors apply. 67<h3>RELATED INFORMATION</h3> 68<p> 69Functions: 70<a href="mach_port_type.html"><strong>mach_port_type</strong></a>. 71