kern/ipc_mig.h Kernel.framework

Sends a message from kernel space, used by the client side of KernelUser MIG interfaces to implement SimpleRoutines; this is the supported variant for kernel extensions (the _proper suffix distinguishes it from the historical unaligned-ABI symbol). The message is copied in from kernel memory and sent with MACH_SEND_KERNEL_DEFAULT semantics and no timeout. Returns MACH_MSG_SUCCESS when the message is sent, MACH_SEND_INVALID_DEST for a bad destination port, or MACH_SEND_NO_BUFFER if a message buffer cannot be obtained; on failure the message contents are destroyed.

Sends a kernel message constructed in place: allocates a kmsg sized for descriptor_count descriptors plus payload_size bytes of payload (payload_size excludes the header and descriptors, and is not the total send size), then invokes the builder block with pointers to the header, the descriptor array (NULL when descriptor_count is 0), and the payload area. A nonzero descriptor count implies a complex message and the builder must set MACH_MSGH_BITS_COMPLEX; the builder must also set msgh_size to the total size. Sent with MACH_SEND_KERNEL_DEFAULT semantics and no timeout. Returns MACH_SEND_NO_BUFFER if the message cannot be allocated, otherwise the send result.

Sends a message from the kernel and receives a reply into the same buffer, using the calling thread's reply port; used by the client side of KernelUser MIG interfaces to implement Routines. This is the supported variant for kernel extensions. msgh_local_port must be MACH_PORT_NULL; the wait for the reply is uninterruptible. Returns MACH_MSG_SUCCESS when the reply is received, MACH_RCV_PORT_DIED if the reply port was deallocated, or a send error; rcv_size bounds the reply.

Destroys an unwanted or unexpected reply message held by a kernel-side MIG user stub, releasing the port rights and descriptor resources the message carries, in the manner of ipc_kmsg_destroy but operating on bare message contents. This is the supported variant for kernel extensions.