osfmk/man/do_mach_notify_no_senders.html

   1 <h2>do_mach_notify_no_senders</h2>
   2 <hr>
   3 <p>
   4 <strong>Server Interface</strong> - Handle the current instance of a no-more-senders notification.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>kern_return_t   do_mach_notify_no_senders</strong>
   8                 <strong>(notify_port_t</strong>                           <var>notify</var>,
   9                  <strong>mach_port_mscount_t</strong>                    <var>mscount</var><strong>);</strong>
  10
  11
  12 <strong>kern_return_t   do_seqnos_mach_notify_no_senders</strong>
  13                 <strong>(notify_port_t</strong>                           <var>notify</var>,
  14                  <strong>mach_port_seqno_t</strong>                        <var>seqno</var>,
  15                  <strong>mach_port_mscount_t</strong>                    <var>mscount</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>mscount</var>
  32 <dd>
  33 [in scalar]
  34 The value the port's make-send count had when the
  35 notification was generated.
  36 </dl>
  37 <h3>DESCRIPTION</h3>
  38 <p>
  39 A <strong>do_mach_notify_no_senders</strong> function is called by
  40 <strong>notify_server</strong> as the
  41 result of a kernel message indicating that a receive right has no more senders.
  42 <var>notify</var> is the port named via <strong>mach_port_request_notification</strong>.
  43 <h3>RETURN VALUES</h3>
  44 <p>
  45 Only generic errors apply.
  46 <h3>RELATED INFORMATION</h3>
  47 <p>
  48 Functions:
  49 <a href="notify_server.html"><strong>notify_server</strong></a>,
  50 <a href="seqnos_notify_server.html"><strong>seqnos_notify_server</strong></a>,
  51 <a href="mach_msg.html"><strong>mach_msg</strong></a>,
  52 <a href="MP_request_notification.html"><strong>mach_port_request_notification</strong></a>,
  53 <a href="do_mach_notify_dead_name.html"><strong>do_mach_notify_dead_name</strong></a>,
  54 <a href="DMN_port_deleted.html"><strong>do_mach_notify_port_deleted</strong></a>,
  55 <a href="do_mach_notify_send_once.html"><strong>do_mach_notify_send_once</strong></a>.