Back to Darwin Xnu

Do Mach Notify Dead Name

osfmk/man/do_mach_notify_dead_name.html

latest1.7 KB
Original Source

do_mach_notify_dead_name


Server Interface - Handle the current instance of a dead-name notification.

SYNOPSIS

**kern\_return\_t do\_mach\_notify\_dead\_name**** (notify\_port\_t **notify,** mach\_port\_name\_t **name** ); ****kern\_return\_t do\_seqnos\_mach\_notify\_dead\_name**** (notify\_port\_t **notify,** mach\_port\_seqno\_t **seqno,** mach\_port\_name\_t **name** );**

PARAMETERS

notify[in notify (receive) right] The port to which the notification was sent.

seqno[in scalar] The sequence number of this message relative to the notification port.

name[in scalar] The dead name.

DESCRIPTION

A do_mach_notify_dead_name function is called by notify_server as the result of a kernel message indicating that the port name is now dead as the result of the associated receive right having died. In contrast, a port-deleted notification indicates that the port name is no longer usable (that is, it no longer names a valid right), typically as a result of the right so named being consumed or moved. notify is the port named via mach_port_request_notification or mach_msg.

NOTES

This interface is machine word length specific because of the port name parameter.

RETURN VALUES

Only generic errors apply.

Functions: notify_server, seqnos_notify_server, mach_msg, mach_port_request_notification, do_mach_notify_no_senders, do_mach_notify_port_deleted, do_mach_notify_send_once.