osfmk/man/DMN_port_destroyed.html

   1 <h2>do_mach_notify_port_destroyed</h2>
   2 <hr>
   3 <p>
   4 <strong>Server Interface</strong> - Handle the current instance of a port-destroyed notification.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>kern_return_t   do_mach_notify_port_destroyed</strong>
   8                 <strong>(notify_port_t</strong>                           <var>notify</var>,
   9                  <strong>mach_port_receive_t</strong>                       <var>name</var><strong>);</strong>
  10
  11
  12 <strong>kern_return_t   do_seqnos_mach_notify_port_destroyed</strong>
  13                 <strong>(mach_port_t</strong>                             <var>notify</var>,
  14                  <strong>mach_port_seqno_t</strong>                        <var>seqno</var>,
  15                  <strong>mach_port_receive_t</strong>                       <var>name</var><strong>);</strong>
  16 </pre>
  17 <h3>PARAMETERS</h3>
  18 <dl>
  19 <p>
  20 <dt> <var>notify</var>
  21 <dd>
  22 [in notify (receive) right]
  23 The port to which the notification was sent.
  24 <p>
  25 <dt> <var>seqno</var>
  26 <dd>
  27 [in scalar]
  28 The sequence number of this message relative to the
  29 notification port.
  30 <p>
  31 <dt> <var>name</var>
  32 <dd>
  33 [in scalar]
  34 The invalid name.
  35 </dl>
  36 <h3>DESCRIPTION</h3>
  37 <p>
  38 A <strong>do_mach_notify_port_destroyed</strong> function is called by
  39 <strong>notify_server</strong> as the
  40 result of a kernel message indicating that a receive right would have
  41 been destroyed.  <var>notify</var> is the port named via
  42 <strong>mach_port_request_notification</strong> or <strong>mach_msg</strong>.
  43 <h3>NOTES</h3>
  44 <p>
  45 This interface is machine word length specific because of the port name
  46 parameter.
  47 <h3>RETURN VALUES</h3>
  48 <p>
  49 Only generic errors apply.
  50 <h3>RELATED INFORMATION</h3>
  51 <p>
  52 Functions:
  53 <a href="notify_server.html"><strong>notify_server</strong></a>,
  54 <a href="seqnos_notify_server.html"><strong>seqnos_notify_server</strong></a>,
  55 <a href="mach_msg.html"><strong>mach_msg</strong></a>,
  56 <a href="MP_request_notification.html"><strong>mach_port_request_notification</strong></a>,
  57 <a href="do_mach_notify_dead_name.html"><strong>do_mach_notify_dead_name</strong></a>,
  58 <a href="do_mach_notify_no_senders.html"><strong>do_mach_notify_no_senders</strong></a>,
  59 <a href="do_mach_notify_send_once.html"><strong>do_mach_notify_send_once</strong></a>.