osfmk/ipc/mach_port.c

387  *		Retrieves the type of a right in the space.
404  *		KERN_INVALID_NAME	The name doesn't denote a right.
447  *		Changes the name denoting a right,
452  *		KERN_SUCCESS		The right is renamed.
455  *		KERN_INVALID_NAME	The oname doesn't denote a right.
457  *		KERN_NAME_EXISTS	The nname already denotes a right.
477  *		Allocates a right in a space, using a specific name
478  *		for the new right.  Possible rights:
496  *		KERN_SUCCESS		The right is allocated.
500  *		KERN_INVALID_VALUE	"right" isn't a legal kind of right.
501  *		KERN_NAME_EXISTS	The name already denotes a right.
512 	mach_port_right_t	right,
523 	kr = mach_port_allocate_full (space, right, MACH_PORT_NULL,
531  *		Allocates a right in a space.  Like mach_port_allocate_name,
532  *		except that the implementation picks a name for the right.
534  *		currently denote a right.
538  *		KERN_SUCCESS		The right is allocated.
541  *		KERN_INVALID_VALUE	"right" isn't a legal kind of right.
543  *		KERN_NO_SPACE		No room in space for another right.
549 	mach_port_right_t	right,
555 	kr = mach_port_allocate_full (space, right, MACH_PORT_NULL,
563  *		Allocates a right, with qos options, in a space.  Like
565  *		picks a name for the right. The name may be any legal name
566  *		in the space that doesn't currently denote a right.
570  *		KERN_SUCCESS		The right is allocated.
573  *		KERN_INVALID_VALUE	"right" isn't a legal kind of right.
576  *		KERN_NO_SPACE		No room in space for another right.
582 	mach_port_right_t	right,
590 	kr = mach_port_allocate_full (space, right, MACH_PORT_NULL,
598  *		Allocates a right in a space.  Supports all of the
602  *		currently denote a right.
606  *		KERN_SUCCESS		The right is allocated.
609  *		KERN_INVALID_VALUE	"right" isn't a legal kind of right.
611  *		KERN_NO_SPACE		No room in space for another right.
617 	mach_port_right_t	right,
642 			if (right != MACH_PORT_RIGHT_RECEIVE)
651 	switch (right) {
700  *		in a space.  The destruction of a receive right
702  *		has been made for it; the destruction of a port-set right
710  *		KERN_INVALID_NAME	The name doesn't denote a right.
739  *		Deallocates a user reference from a send right,
740  *		send-once right, or a dead-name right.  May
741  *		deallocate the right, if this is the last uref,
750  *		KERN_INVALID_NAME	The name doesn't denote a right.
751  *		KERN_INVALID_RIGHT	The right isn't correct.
780  *		Retrieves the number of user references held by a right.
783  *		name denotes a right, but not the queried right.
790  *		KERN_INVALID_VALUE	"right" isn't a legal value.
791  *		KERN_INVALID_NAME	The name doesn't denote a right.
798 	mach_port_right_t	right,
809 	if (right >= MACH_PORT_RIGHT_NUMBER)
813 	  	if (right == MACH_PORT_RIGHT_SEND ||
814 		    right == MACH_PORT_RIGHT_SEND_ONCE) {
832 	if (type & MACH_PORT_TYPE(right))
833 		switch (right) {
861  *		Modifies the number of user references held by a right.
863  *		If it is zero, the right is deallocated.  If the name
871  *		KERN_INVALID_VALUE	"right" isn't a legal value.
872  *		KERN_INVALID_NAME	The name doesn't denote a right.
873  *		KERN_INVALID_RIGHT	Name doesn't denote specified right.
882 	mach_port_right_t	right,
891 	if (right >= MACH_PORT_RIGHT_NUMBER)
895 		if (right == MACH_PORT_RIGHT_SEND ||
896 		    right == MACH_PORT_RIGHT_SEND_ONCE)
906 	kr = ipc_right_delta(space, name, entry, right, delta);	/* unlocks */
914  *		Changes a receive right's make-send count.
921  *		KERN_INVALID_NAME	The name doesn't denote a right.
954  *		Changes a receive right's sequence number.
961  *		KERN_INVALID_NAME	The name doesn't denote a right.
994  *		Returns a receive right's context pointer.
1001  *		KERN_INVALID_NAME	The name doesn't denote a right.
1035  *		Changes a receive right's context pointer.
1042  *		KERN_INVALID_NAME	The name doesn't denote a right.
1076  *		portspace is locked for both the recieve right and pset
1115  *		Returns the space's name for each receive right member.
1122  *		KERN_INVALID_NAME	The name doesn't denote a right.
1260  *		KERN_INVALID_NAME	Member didn't denote a right.
1261  *		KERN_INVALID_RIGHT	Member didn't denote a receive right.
1262  *		KERN_INVALID_NAME	After didn't denote a right.
1263  *		KERN_INVALID_RIGHT	After didn't denote a port set right.
1356  *		a send-once right for the notification to use,
1358  *		send-once right, if any.  Possible types:
1362  *			for a receive right.  Sync should be zero.
1365  *			receive right.  If there are currently no
1367  *			current make-send count, and a send-once right
1372  *			or receive right.  If the name is already a
1374  *			right is supplied, then an immediate dead-name
1383  *		KERN_INVALID_NAME	Name doesn't denote a right.
1384  *		KERN_INVALID_RIGHT	Name doesn't denote appropriate right.
1514  *		Inserts a right into a space, as if the space
1515  *		voluntarily received the right in a message,
1516  *		except that the right gets the specified name.
1520  *		KERN_SUCCESS		Inserted the right.
1524  *		KERN_NAME_EXISTS	The name already denotes a right.
1525  *		KERN_INVALID_VALUE	Message doesn't carry a port right.
1556  *		Extracts a right from a space, as if the space
1557  *		voluntarily sent the right to the caller.
1561  *		KERN_SUCCESS		Extracted the right.
1564  *		KERN_INVALID_VALUE	Requested type isn't a port right.
1565  *		KERN_INVALID_NAME	Name doesn't denote a right.
1566  *		KERN_INVALID_RIGHT	Name doesn't denote appropriate right.
1588 		 * send-once right being copied, but instead return an
1774  *		Add the receive right, specified by name, to
1783  *		KERN_INVALID_NAME	name didn't denote a right.
1784  *		KERN_INVALID_RIGHT	name didn't denote a receive right.
1785  *		KERN_INVALID_NAME	pset_name didn't denote a right.
1786  *		KERN_INVALID_RIGHT	pset_name didn't denote a portset right.
1840  *		KERN_INVALID_NAME	Member didn't denote a right.
1841  *		KERN_INVALID_RIGHT	Member didn't denote a receive right.
1842  *		KERN_INVALID_NAME	After didn't denote a right.
1843  *		KERN_INVALID_RIGHT	After didn't denote a port set right.