osfmk/man/do_mach_notify_send_once.html

   1 <h2>do_mach_notify_send_once</h2>
   2 <hr>
   3 <p>
   4 <strong>Server Interface</strong> - Handle the current instance of a send-once notification.
   5 <h3>SYNOPSIS</h3>
   6 <pre>
   7 <strong>kern_return_t   do_mach_notify_send_once</strong>
   8                 <strong>(notify_port_t</strong>                          <var>notify</var><strong>)</strong>
   9
  10
  11 <strong>kern_return_t   do_seqnos_mach_notify_send_once</strong>
  12                 <strong>(notify_port_t</strong>                           <var>notify</var>,
  13                  <strong>mach_port_seqno_t</strong>                        <var>seqno</var><strong>);</strong>
  14 </pre>
  15 <h3>PARAMETERS</h3>
  16 <dl>
  17 <p>
  18 <dt> <var>notify</var>
  19 <dd>
  20 [in notify (receive) right]
  21 The port to which the notification was sent.
  22 <p>
  23 <dt> <var>seqno</var>
  24 <dd>
  25 [in scalar]
  26 The sequence number of this message relative to the
  27 notification port.
  28 </dl>
  29 <h3>DESCRIPTION</h3>
  30 <p>
  31 A <strong>do_mach_notify_send_once</strong> function is called by <strong>notify_server</strong>
  32 as the result
  33 of a kernel message indicating that a send-once right was in
  34 any way destroyed.
  35 <var>notify</var> is the port for which a send-once right was destroyed.
  36 <h3>RETURN VALUES</h3>
  37 <p>
  38 Only generic errors apply.
  39 <h3>RELATED INFORMATION</h3>
  40 <p>
  41 Functions:
  42 <a href="notify_server.html"><strong>notify_server</strong></a>,
  43 <a href="seqnos_notify_server.html"><strong>seqnos_notify_server</strong></a>,
  44 <a href="mach_msg.html"><strong>mach_msg</strong></a>,
  45 <a href="MP_request_notification.html"><strong>mach_port_request_notification</strong></a>,
  46 <a href="do_mach_notify_no_senders.html"><strong>do_mach_notify_no_senders</strong></a>,
  47 <a href="DMN_port_deleted.html"><strong>do_mach_notify_port_deleted</strong></a>,
  48 <a href="do_mach_notify_dead_name.html"><strong>do_mach_notify_dead_name</strong></a>.