osfmk/ipc/ipc_kmsg.c

77 #include <mach/message.h>
569  *	We keep a per-processor cache of kernel message buffers.
579  *		Allocate a kernel message structure.  If we can get one from
594 	 * message descrptors for user spaces with pointers larger than
658  *		Free a kernel message buffer.  If the kms is preallocated
661  *		on our message released.  In that case, we have to just
662  *		revert the message to a traditional one and free it normally.
681 	 * Check to see if the message is bound to the port.  If so,
683 	 * leave the message associated with it.  Otherwise, free it.
817  *		Destroys a kernel message.  Releases all rights,
818  *		references, and memory held by the message.
819  *		Frees the message.
829 	 *	Destroying a message can cause more messages to be destroyed.
831 	 *	destruction queue.  If this was the first message on the
841  *		Enqueues a kernel message for deferred destruction.
886  *		Cleans the body of a kernel message.
914 		 * Destroy port rights carried in the message
928 		 * Destroy memory carried in the message
951 		/* destroy port rights carried in the message */
962 		/* destroy memory carried in the message */
980  *		Cleans a partially-acquired kernel message.
982  *		in the body of the message that contained the error.
1029  *		Cleans a kernel message.  Releases all rights,
1030  *		references, and memory held by the message.
1073  *		Assign a kmsg as a preallocated message buffer to a port.
1092  *		Release the Assignment of a preallocated message buffer from a port.
1129  *		Allocates a kernel message buffer.
1130  *		Copies a user message to the message buffer.
1134  *		MACH_MSG_SUCCESS	Acquired a message buffer.
1138  *		MACH_SEND_NO_BUFFER	Couldn't allocate a message buffer.
1139  *		MACH_SEND_INVALID_DATA	Couldn't copy message data.
1254  *		First checks for a preallocated message
1256  *		allocates a new kernel message buffer.
1257  *		Copies a kernel message to the message buffer.
1263  *		MACH_MSG_SUCCESS	Acquired a message buffer.
1264  *		MACH_SEND_NO_BUFFER	Couldn't allocate a message buffer.
1352  *		Send a message.  The message holds a reference
1356  *		the message and must do something with it.  If successful,
1357  *		the message is queued, given to a receiver, destroyed,
1362  *		MACH_MSG_SUCCESS	The message was accepted.
1363  *		MACH_SEND_TIMED_OUT	Caller still has message.
1364  *		MACH_SEND_INTERRUPTED	Caller still has message.
1365  *		MACH_SEND_INVALID_DEST	Caller still has message.
1428 		 * Call the server routine, and get the reply message to send.
1442 	 * Need to see if this message needs importance donation and/or
1454 	 * We have a valid message and a valid reference on the port.
1455 	 * we can unlock the port and call mqueue_send() on its message
1456 	 * queue. Lock message queue while port is locked.
1504 	 * If the port has been destroyed while we wait, treat the message
1519  *		Copies a message buffer to a user message.
1521  *		Frees the message buffer.
1523  *		Nothing locked.  The message buffer must have clean
1526  *		MACH_MSG_SUCCESS	Copied data out of message buffer.
1527  *		MACH_RCV_INVALID_DATA	Couldn't copy to user message.
1603  *		Copies a message buffer to a kernel message.
1604  *		Frees the message buffer.
1624  *		"Copy-in" port rights in the header of a message.
1626  *		message header and the space are left untouched.
1637  *			Illegal value in the message header bits.
2436  *		in the message body.
2438  *		In all failure cases, the message is left holding
2439  *		no rights or memory.  However, the message buffer
2440  *		is not deallocated.  If successful, the message
2497 	/* make sure the descriptor fits in the message */
2559 		     * Per message kernel memory limit exceeded
2593         /* Update the message size for the larger in-kernel representation */
2630             /* clean from start of message descriptors to i */
2650  *		in the message.
2652  *		In all failure cases, the message is left holding
2653  *		no rights or memory.  However, the message buffer
2654  *		is not deallocated.  If successful, the message
2661  *			Illegal value in the message header bits.
2726  *		in a message sent from the kernel.
2728  *		Because the message comes from the kernel,
2730  *		or peculiarities in the message.
2754 	 *	The common case is a complex message with no reply port,
2888 	 *	The common case is a complex message with no reply port,
2921         /* Update the message size for the larger in-kernel representation */
3045  *		"Copy-out" port rights in the header of a message.
3047  *		message header and the space are left untouched.
3083 	 * the message.
3273 	 *	receiving the message and this copyout.  If the destination
3442     /* Copyout port right carried in the message */
3685             /* copyout port rights carried in the message */
3755  *		in the body of a message.
3819                           panic("untyped IPC copyout body: invalid message descriptor");
3828         /* Update the message size for the smaller user representation */
3838  *		Compute the size of the message as copied out to the given
3845  *		size of the message as it would be received.
3895  *		in the message.
3901  *			Rights and memory in the message are intact.
3903  *			The message header was successfully copied out.
3935  *		Does a pseudo-copyout of the message.
4009  *		Copies out the destination port in the message.
4010  *		Destroys all other rights and memory in the message.
4102  *              the allocated message body containing the scatter list.
4241  *		Copies out the destination and reply ports in the message.
4242  *		Leaves all other rights and memory in the message alone.
4401         /* Update the message size for the smaller user representation */