osfmk/man/mach_port_insert_member.html

   1 <!doctype html public "-//w3c//dtd html 4.0 transitional//en">
   2 <html>
   3 <head>
   4    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   5    <meta name="GENERATOR" content="Mozilla/4.73 (Macintosh; U; PPC) [Netscape]">
   6    <title>mach_port_insert_member.html</title>
   7 </head>
   8 <body>
   9
  10 <h2>
  11 mach_port_insert_member</h2>
  12
  13 <hr>
  14 <p><b>Function</b> - Move the specified receive right into or out of the
  15 specified port set.
  16 <h3>
  17 SYNOPSIS</h3>
  18
  19 <pre><b>kern_return_t&nbsp;&nbsp; mach_port_insert_member
  20 </b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <b>(ipc_space_t</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>task</i>,
  21 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <b>mach_port_name_t</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>member</i>,
  22 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <b>mach_port_name_t</b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>set</i><b>);</b></pre>
  23
  24 <h3>
  25 PARAMETERS</h3>
  26
  27 <dl>
  28 <dt>
  29 <i>task</i></dt>
  30
  31 <dd>
  32 [in task send right] The task holding the port set and receive right.</dd>
  33
  34 <dt>
  35 <i>member</i></dt>
  36
  37 <dd>
  38 [in scalar] The task's name for the receive right.</dd>
  39
  40 <dt>
  41 <i>set</i></dt>
  42
  43 <dd>
  44 [in scalar] The task's name for the port set.</dd>
  45 </dl>
  46
  47 <h3>
  48 DESCRIPTION</h3>
  49 The <b>mach_port_insert_member</b> function adds a receive right to a port
  50 set. If the receive right is already a member of another port set, that
  51 relationship is unafected by this operation.&nbsp; A receive right can
  52 be in multiple port sets simultaneously.
  53 <h3>
  54 NOTES</h3>
  55 This interface is machine word length specific because of the port name
  56 parameter.
  57 <h3>
  58 RETURN VALUES</h3>
  59
  60 <dl>
  61 <dt>
  62 <b>KERN_INVALID_NAME</b></dt>
  63
  64 <dd>
  65 <i>member</i> or <i>set</i> did not denote a right.</dd>
  66
  67 <dt>
  68 <b>KERN_INVALID_RIGHT</b></dt>
  69
  70 <dd>
  71 <i>member</i> denoted a right, but not a receive right, or <i>set</i> denoted
  72 a right, but not a port set.</dd>
  73 </dl>
  74
  75 <h3>
  76 RELATED INFORMATION</h3>
  77 Functions:
  78 <b><a href="HTML/mach_port_extract_member.html">mach_port_extract_member</a></b>,
  79 <b><a href="HTML/mach_port_move_member.html">mach_port_move_member</a></b>,
  80 <b><a href="HTML/mach_port_get_set_status.html">mach_port_get_set_status</a></b>,
  81 <b><a href="HTML/mach_port_get_attributes.html">mach_port_get_attributes</a></b>.
  82 </body>
  83 </html>