projects / apple / xnu.git / blame
| Commit | Line | Data |
|---|---|---|
| 13fec989 A |
1 | <h2>do_mach_notify_dead_name</h2> |
| 2 | <hr> | |
| 3 | <strong>Server Interface</strong> - Handle the current instance of a dead-name notification. | |
| 4 | <p> | |
| 5 | <h3>SYNOPSIS</h3> | |
| 6 | <pre> | |
| 7 | <strong>kern_return_t do_mach_notify_dead_name</strong> | |
| 8 | <strong>(notify_port_t</strong> <var>notify</var>, | |
| 9 | <strong>mach_port_name_t</strong> <var>name</var><strong>);</strong> | |
| 10 | ||
| 11 | ||
| 12 | <strong>kern_return_t do_seqnos_mach_notify_dead_name</strong> | |
| 13 | <strong>(notify_port_t</strong> <var>notify</var>, | |
| 14 | <strong>mach_port_seqno_t</strong> <var>seqno</var>, | |
| 15 | <strong>mach_port_name_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 dead name. | |
| 35 | </dl> | |
| 36 | <h3>DESCRIPTION</h3> | |
| 37 | <p> | |
| 38 | A <strong>do_mach_notify_dead_name</strong> function is called by <strong>notify_server</strong> | |
| 39 | as the | |
| 40 | result of a kernel message indicating that the port name is now | |
| 41 | dead as the result | |
| 42 | of the associated receive right having died. In contrast, a port-deleted | |
| 43 | notification indicates that the port name is no longer usable | |
| 44 | (that is, it no longer names | |
| 45 | a valid right), typically as a result of the right so named being consumed or | |
| 46 | moved. <var>notify</var> is the port named via <strong>mach_port_request_notification</strong> | |
| 47 | or | |
| 48 | <strong>mach_msg</strong>. | |
| 49 | <h3>NOTES</h3> | |
| 50 | <p> | |
| 51 | This interface is machine word length specific because of the port name | |
| 52 | parameter. | |
| 53 | <h3>RETURN VALUES</h3> | |
| 54 | <p> | |
| 55 | Only generic errors apply. | |
| 56 | <h3>RELATED INFORMATION</h3> | |
| 57 | <p> | |
| 58 | Functions: | |
| 59 | <a href="notify_server.html"><strong>notify_server</strong></a>, | |
| 60 | <a href="seqnos_notify_server.html"><strong>seqnos_notify_server</strong></a>, | |
| 61 | <a href="mach_msg.html"><strong>mach_msg</strong></a>, | |
| 62 | <a href="MP_request_notification.html"><strong>mach_port_request_notification</strong></a>, | |
| 63 | <a href="do_mach_notify_no_senders.html"><strong>do_mach_notify_no_senders</strong></a>, | |
| 64 | <a href="DMN_port_deleted.html"><strong>do_mach_notify_port_deleted</strong></a>, | |
| 65 | <a href="do_mach_notify_send_once.html"><strong>do_mach_notify_send_once</strong></a>. |