Back to Darwin Xnu

mach_port_insert_member.html

osfmk/man/mach_port_move_member.html

latest1.5 KB
Original Source

mach_port_move_member


Function - Move the specified receive right into or out of the specified port set.

SYNOPSIS

**kern\_return\_t mach\_port\_move\_member** **(ipc\_space\_t**_task_, **mach\_port\_name\_t** _member_, **mach\_port\_name\_t** _after_**);**

PARAMETERS

task[in task send right] The task holding the port set and receive right.member[in scalar] The task's name for the receive right.after[in scalar] The task's name for the port set.

DESCRIPTION

The mach_port_move_member function moves a receive right into a port set. If the receive right is already a member of any other port sets, it is removed from those sets first. If the port set is MACH_PORT_NULL , then the receive right is not put into a port set, but removed from all its current port sets.

NOTES

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

RETURN VALUES

KERN_INVALID_NAME member or after did not denote a right. KERN_INVALID_RIGHT member denoted a right, but not a receive right, or after denoted a right, but not a port set. KERN_NOT_IN_SET after was MACH_PORT_NULL , but member wasn't currently in a port set.

Functions: mach_port_insert_member, mach_port_extract_member, mach_port_get_set_status, mach_port_get_attributes.