X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..39236c6e673c41db228275375ab7fdb0f837b292:/osfmk/man/mach_port_set_mscount.html diff --git a/osfmk/man/mach_port_set_mscount.html b/osfmk/man/mach_port_set_mscount.html old mode 100755 new mode 100644 index d42f8eb82..c427702a6 --- a/osfmk/man/mach_port_set_mscount.html +++ b/osfmk/man/mach_port_set_mscount.html @@ -1 +1,57 @@ -

mach_port_set_mscount


Function - Change the target port's make-send count.

SYNOPSIS

kern_return_t   mach_port_set_mscount
                (ipc_space_t                               task,
                 mach_port_name_t                          name,
                 mach_port_mscount_t                    mscount);

PARAMETERS

task
[in task send right] The task owning the receive right.

name
[in scalar] task's name for the receive right.

mscount
[in scalar] New value for the make-send count for the receive right.

DESCRIPTION

The mach_port_set_mscount function changes the make-send count of task's receive right named name. A port's make-send count specifies the number of send rights that have been generated via the port's receive right. A port's make-send count is set to zero when the port is first allocated; the count is reset to zero each time the port's receive right is transferred via a Mach message.

NOTES

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

RETURN VALUES

KERN_INVALID_NAME
name did not denote a right.

KERN_INVALID_RIGHT
name denoted a right, but not a receive right.

RELATED INFORMATION

Functions: mach_port_get_attributes. \ No newline at end of file +

mach_port_set_mscount

+
+

+Function - Change the target port's make-send count. +

SYNOPSIS

+
+kern_return_t   mach_port_set_mscount
+                (ipc_space_t                               task,
+                 mach_port_name_t                          name,
+                 mach_port_mscount_t                    mscount);
+
+

PARAMETERS

+
+

+

task +
+[in task send right] +The task owning the receive right. +

+

name +
+[in scalar] +task's name for the receive right. +

+

mscount +
+[in scalar] +New value for the make-send count for the receive right. +
+

DESCRIPTION

+

+The mach_port_set_mscount function changes the make-send +count of task's +receive right named name. +A port's make-send count specifies the number of send rights that have +been generated via the port's receive right. A port's make-send count +is set to zero when the port is first allocated; the count is reset to +zero each time the port's receive right is transferred via a Mach message. +

NOTES

+

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

RETURN VALUES

+
+

+

KERN_INVALID_NAME +
+name did not denote a right. +

+

KERN_INVALID_RIGHT +
+name denoted a right, but not a receive right. +
+

RELATED INFORMATION

+

+Functions: +mach_port_get_attributes.