X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/9bccf70c0258c7cac2dcb80011b2a964d884c552..13fec9890cf095cc781fdf7b8917cb03bf32dd4c:/osfmk/man/mach_port_move_member.html diff --git a/osfmk/man/mach_port_move_member.html b/osfmk/man/mach_port_move_member.html index c21248329..2429a8632 100755 --- a/osfmk/man/mach_port_move_member.html +++ b/osfmk/man/mach_port_move_member.html @@ -1 +1,95 @@ - mach_port_insert_member.html

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.

RELATED INFORMATION

Functions: mach_port_insert_member, mach_port_extract_member, mach_port_get_set_status, mach_port_get_attributes.

\ No newline at end of file + + + + + + mach_port_insert_member.html + + + +

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

+RELATED INFORMATION

+ +

+Functions: +mach_port_insert_member, +mach_port_extract_member, +mach_port_get_set_status, +mach_port_get_attributes. +

+ + +