Back to Darwin Xnu

Mach Port Set Mscount

osfmk/man/mach_port_set_mscount.html

latest1.2 KB
Original Source

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.

Functions: mach_port_get_attributes.