1218885Sdim<h2>mach_port_set_attributes</h2>
2218885Sdim<hr>
3218885Sdim<p>
4218885Sdim<strong>Function</strong> - Set the target port's attributes.
5218885Sdim<h3>SYNOPSIS</h3>
6218885Sdim<pre>
7218885Sdim<strong>kern_return_t   mach_port_set_attributes</strong>
8218885Sdim                <strong>(ipc_space_t</strong>                               <var>task</var>,
9218885Sdim                 <strong>mach_port_name_t</strong>                          <var>name</var>,
10218885Sdim                 <strong>mach_port_flavor_t</strong>                      <var>flavor</var>,
11218885Sdim                 <strong>mach_port_info_t</strong>                     <var>port_info</var>,
12218885Sdim                 <strong>mach_msg_type_number_t</strong>         <var>port_info_count</var><strong>);</strong>
13221345Sdim</pre>
14221345Sdim<h3>PARAMETERS</h3>
15218885Sdim<dl>
16218885Sdim<p>
17218885Sdim<dt> <var>task</var> 
18218885Sdim<dd>
19218885Sdim[in task send right]
20218885SdimThe task holding a receive right to the port in
21218885Sdimquestion.
22218885Sdim<p>
23218885Sdim<dt> <var>name</var> 
24218885Sdim<dd>
25218885Sdim[in scalar]
26218885Sdim<var>task</var>'s name for the port.
27280031Sdim<p>
28280031Sdim<dt> <var>flavor</var> 
29218885Sdim<dd>
30221345Sdim[in scalar]
31221345SdimThe type of attributes to be set.  Valid values are:
32218885Sdim<dl>
33261991Sdim<p>
34218885Sdim<dt> <strong>MACH_PORT_LIMITS_INFO</strong>
35218885Sdim<dd>
36218885SdimSets resource limits (queue limits) for the port.  The declaration 
37218885Sdimof this data is found in structure <strong>mach_port_limits</strong>.
38218885Sdim</dl>
39218885Sdim<p>
40218885Sdim<dt> <var>port_info</var> 
41276479Sdim<dd>
42218885Sdim[pointer to in structure]
43280031SdimAttributes for the specified port.
44218885Sdim<p>
45218885Sdim<dt> <var>port_info_count</var> 
46218885Sdim<dd>
47218885Sdim[in scalar]
48276479SdimThe size of the buffer (in natural-sized units).
49218885Sdim</dl>
50218885Sdim</dl>
51221345Sdim<h3>DESCRIPTION</h3>
52218885Sdim<p>
53218885SdimThe <strong>mach_port_set_attributes</strong> function sets attributes of type 
54218885Sdim<var>flavor</var>.
55221345Sdim<h3>NOTES</h3>
56221345Sdim<p>
57221345SdimThis interface is machine word length specific because of the port name
58221345Sdimparameter.
59221345Sdim<h3>RETURN VALUES</h3>
60221345Sdim<dl>
61221345Sdim<p>
62221345Sdim<dt> <strong>KERN_INVALID_NAME</strong>
63280031Sdim<dd>
64221345Sdim<var>name</var> did not denote a right.
65280031Sdim<p>
66280031Sdim<dt> <strong>KERN_INVALID_RIGHT</strong>
67280031Sdim<dd>
68280031Sdim<var>name</var> denoted a right, but not a receive right.
69218885Sdim</dl>
70218885Sdim<h3>RELATED INFORMATION</h3>
71218885Sdim<p>
72276479SdimFunctions:
73288943Sdim<a href="mach_port_allocate.html"><strong>mach_port_allocate</strong></a>,
74218885Sdim<a href="mach_port_allocate_name.html"><strong>mach_port_allocate_name</strong></a>,
75218885Sdim<a href="mach_port_get_attributes.html"><strong>mach_port_get_attributes</strong></a>.
76218885Sdim<p>
77218885SdimData Structures:
78218885Sdim<a href="mach_port_limits.html"><strong>mach_port_limits</strong></a>.
79218885Sdim