1<h2>processor_set_create</h2>
2<hr>
3<p>
4<strong>Function</strong> - Create a new processor set object.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t	processor_set_create</strong>
8		<strong>(host_t</strong>	<var>host_name</var>,
9		<strong>processor_set_t</strong>	<var>new_set</var>,
10		<strong>processor_set_name_t</strong>	<var>new_name</var><strong>);</strong>
11</pre>
12<h3>PARAMETERS</h3>
13<dl>
14<dt> <var>host_name</var> 
15<dd>
16[in host-name send right]
17The name (or control) port for the host on 
18which the set is to be created.
19<dt> <var>new_set</var> 
20<dd>
21[out processor-set-control send right]
22Control port used for performing 
23operations on the new set.
24<dt> <var>new_name</var> 
25<dd>
26[out processor-set-name send right]
27Name port used to identify the new 
28set and obtain information about it.
29</dl>
30<h3>DESCRIPTION</h3>
31<p>
32The <strong>processor_set_create</strong> function creates a new processor
33set and returns the 
34two ports associated with it.  The port returned in <var>new_set</var> is the control port
35representing the set.  It is used to perform operations such
36as assigning processors, 
37tasks or threads.  The port returned in <var>new_name</var> is the name port which
38identifies the set, and is used to obtain information about the set.
39<h3>RETURN VALUES</h3>
40<p>
41Only generic values apply.
42<h3>RELATED INFORMATION</h3>
43<p>
44Functions:
45<a href="processor_set_destroy.html">processor_set_destroy</a>,
46<a href="processor_set_info.html">processor_set_info</a>,
47<a href="processor_assign.html">processor_assign</a>,
48<a href="task_assign.html">task_assign</a>,
49<a href="thread_assign.html">thread_assign</a>.
50