X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..39236c6e673c41db228275375ab7fdb0f837b292:/osfmk/man/do_mach_notify_dead_name.html diff --git a/osfmk/man/do_mach_notify_dead_name.html b/osfmk/man/do_mach_notify_dead_name.html old mode 100755 new mode 100644 index ffc3c74f4..2f3ffe6c8 --- a/osfmk/man/do_mach_notify_dead_name.html +++ b/osfmk/man/do_mach_notify_dead_name.html @@ -1 +1,65 @@ -

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.

RELATED INFORMATION

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. \ No newline at end of file +

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. +

RELATED INFORMATION

+

+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.