X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/378393581903b274cb7a4d18e0d978071a6b592d..cb3231590a3c94ab4375e2228bd5e86b0cf1ad7e:/osfmk/kern/ipc_mig.h diff --git a/osfmk/kern/ipc_mig.h b/osfmk/kern/ipc_mig.h index e25e071ad..a4fad67e1 100644 --- a/osfmk/kern/ipc_mig.h +++ b/osfmk/kern/ipc_mig.h @@ -1,30 +1,36 @@ /* * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved. * - * @APPLE_LICENSE_HEADER_START@ - * - * The contents of this file constitute Original Code as defined in and - * are subject to the Apple Public Source License Version 1.1 (the - * "License"). You may not use this file except in compliance with the - * License. Please obtain a copy of the License at - * http://www.apple.com/publicsource and read it before using this file. - * - * This Original Code and all software distributed under the License are - * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER + * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ + * + * This file contains Original Code and/or Modifications of Original Code + * as defined in and that are subject to the Apple Public Source License + * Version 2.0 (the 'License'). You may not use this file except in + * compliance with the License. The rights granted to you under the License + * may not be used to create, or enable the creation or redistribution of, + * unlawful or unlicensed copies of an Apple operating system, or to + * circumvent, violate, or enable the circumvention or violation of, any + * terms of an Apple operating system software license agreement. + * + * Please obtain a copy of the License at + * http://www.opensource.apple.com/apsl/ and read it before using this file. + * + * The Original Code and all software distributed under the License are + * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, - * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the - * License for the specific language governing rights and limitations - * under the License. - * - * @APPLE_LICENSE_HEADER_END@ + * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. + * Please see the License for the specific language governing rights and + * limitations under the License. + * + * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ */ /* * @OSF_COPYRIGHT@ */ -#ifndef _KERN_IPC_MIG_H_ -#define _KERN_IPC_MIG_H_ +#ifndef _KERN_IPC_MIG_H_ +#define _KERN_IPC_MIG_H_ #include #include @@ -33,7 +39,7 @@ #include -#ifdef XNU_KERNEL_PRIVATE +#ifdef XNU_KERNEL_PRIVATE #include @@ -43,118 +49,159 @@ */ #ifdef _MIG_TRACE_PARAMETERS_ -#define __BeforeRcvCallTrace(msgid,arg1,arg2,arg3,arg4) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ - (unsigned int)(arg1), \ - (unsigned int)(arg2), \ - (unsigned int)(arg3), \ - (unsigned int)(arg4), \ - (unsigned int)(0)); - -#define __AfterRcvCallTrace(msgid,arg1,arg2,arg3,arg4) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ - (unsigned int)(arg1), \ - (unsigned int)(arg2), \ - (unsigned int)(arg3), \ - (unsigned int)(arg4), \ - (unsigned int)(0)); - -#define __BeforeSimpleCallTrace(msgid,arg1,arg2,arg3,arg4) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ - (unsigned int)(arg1), \ - (unsigned int)(arg2), \ - (unsigned int)(arg3), \ - (unsigned int)(arg4), \ - (unsigned int)(0)); - -#define __AfterSimpleCallTrace(msgid,arg1,arg2,arg3,arg4) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ - (unsigned int)(arg1), \ - (unsigned int)(arg2), \ - (unsigned int)(arg3), \ - (unsigned int)(arg4), \ - (unsigned int)(0)); +#define __BeforeRcvCallTrace(msgid, arg1, arg2, arg3, arg4) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ + (unsigned int)(arg1), \ + (unsigned int)(arg2), \ + (unsigned int)(arg3), \ + (unsigned int)(arg4), \ + (unsigned int)(0)); + +#define __AfterRcvCallTrace(msgid, arg1, arg2, arg3, arg4) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ + (unsigned int)(arg1), \ + (unsigned int)(arg2), \ + (unsigned int)(arg3), \ + (unsigned int)(arg4), \ + (unsigned int)(0)); + +#define __BeforeSimpleCallTrace(msgid, arg1, arg2, arg3, arg4) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ + (unsigned int)(arg1), \ + (unsigned int)(arg2), \ + (unsigned int)(arg3), \ + (unsigned int)(arg4), \ + (unsigned int)(0)); + +#define __AfterSimpleCallTrace(msgid, arg1, arg2, arg3, arg4) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ + (unsigned int)(arg1), \ + (unsigned int)(arg2), \ + (unsigned int)(arg3), \ + (unsigned int)(arg4), \ + (unsigned int)(0)); #else /* !_MIG_TRACE_PARAMETERS_ */ -#define __BeforeRcvRpc(msgid, _NAME_) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0)); - -#define __AfterRcvRpc(msgid, _NAME_) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0)); - - -#define __BeforeRcvSimple(msgid, _NAME_) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0)); - -#define __AfterRcvSimple(msgid, _NAME_) \ - KERNEL_DEBUG_CONSTANT(KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0)); +#define __BeforeRcvRpc(msgid, _NAME_) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0)); + +#define __AfterRcvRpc(msgid, _NAME_) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0)); + + +#define __BeforeRcvSimple(msgid, _NAME_) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_START, \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0)); + +#define __AfterRcvSimple(msgid, _NAME_) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + KDBG_MIGCODE(msgid) | DBG_FUNC_END, \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0)); #endif /* !_MIG_TRACE_PARAMETERS_ */ -#define _MIG_MSGID_INVALID(msgid) \ - KERNEL_DEBUG_CONSTANT(MACHDBG_CODE(DBG_MACH_MSGID_INVALID, (msgid)), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0), \ - (unsigned int)(0)) +#define _MIG_MSGID_INVALID(msgid) \ + KERNEL_DEBUG_CONSTANT_IST(KDEBUG_TRACE, \ + MACHDBG_CODE(DBG_MACH_MSGID_INVALID, (msgid)), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0), \ + (unsigned int)(0)) -#endif /* XNU_KERNEL_PRIVATE */ +#endif /* XNU_KERNEL_PRIVATE */ __BEGIN_DECLS /* Send a message from the kernel */ -extern mach_msg_return_t mach_msg_send_from_kernel( - mach_msg_header_t *msg, - mach_msg_size_t send_size); - -extern mach_msg_return_t mach_msg_rpc_from_kernel( - mach_msg_header_t *msg, - mach_msg_size_t send_size, - mach_msg_size_t rcv_size); +extern mach_msg_return_t mach_msg_send_from_kernel_proper( + mach_msg_header_t *msg, + mach_msg_size_t send_size); + +#define mach_msg_send_from_kernel mach_msg_send_from_kernel_proper + +extern mach_msg_return_t +mach_msg_rpc_from_kernel_proper( + mach_msg_header_t *msg, + mach_msg_size_t send_size, + mach_msg_size_t rcv_size); + +#define mach_msg_rpc_from_kernel mach_msg_rpc_from_kernel_proper + +extern void +mach_msg_destroy_from_kernel_proper( + mach_msg_header_t *msg); + +#define mach_msg_destroy_from_kernel mach_msg_destroy_from_kernel_proper + +#ifdef XNU_KERNEL_PRIVATE +extern mach_msg_return_t mach_msg_send_from_kernel_with_options_legacy( + mach_msg_header_t *msg, + mach_msg_size_t send_size, + mach_msg_option_t option, + mach_msg_timeout_t timeout_val); + +extern mach_msg_return_t mach_msg_send_from_kernel_with_options( + mach_msg_header_t *msg, + mach_msg_size_t send_size, + mach_msg_option_t option, + mach_msg_timeout_t timeout_val) +__XNU_INTERNAL(mach_msg_send_from_kernel_with_options); +#else +extern mach_msg_return_t mach_msg_send_from_kernel_with_options( + mach_msg_header_t *msg, + mach_msg_size_t send_size, + mach_msg_option_t option, + mach_msg_timeout_t timeout_val); +#endif /* XNU_KERNEL_PRIVATE */ __END_DECLS -#ifdef MACH_KERNEL_PRIVATE +#ifdef MACH_KERNEL_PRIVATE extern void mach_msg_receive_continue(void); /* Initialize kernel server dispatch table */ -extern void mig_init(void); +extern void mig_init(void); /* * Kernel implementation of the MIG object base class * * Conforms to the MIGObjectInterface defined in * Ports are automatically allocated for the duration of outstanding - * cross-task references and then released. + * cross-task references and then released. */ typedef struct mig_object { - const IMIGObjectVtbl *pVtbl; /* our interface def */ - mach_port_t port; /* our port pointer */ + const IMIGObjectVtbl *pVtbl; /* our interface def */ + mach_port_t port; /* our port pointer */ } mig_object_data_t; @@ -165,34 +212,33 @@ typedef struct mig_object { * chain and deliver the appropriate notification. */ typedef struct mig_notify_object { - const IMIGNotifyObjectVtbl *pVtbl; /* our interface def */ - mach_port_t port; /* our port pointer */ + const IMIGNotifyObjectVtbl *pVtbl; /* our interface def */ + mach_port_t port; /* our port pointer */ } mig_notify_object_data_t; extern kern_return_t mig_object_init( - mig_object_t mig_object, - const IMIGObject *interface); + mig_object_t mig_object, + const IMIGObject *interface); extern void mig_object_destroy( - mig_object_t mig_object); + mig_object_t mig_object); extern void mig_object_reference( - mig_object_t mig_object); + mig_object_t mig_object); extern void mig_object_deallocate( - mig_object_t mig_object); + mig_object_t mig_object); extern ipc_port_t convert_mig_object_to_port( - mig_object_t mig_object); + mig_object_t mig_object); extern mig_object_t convert_port_to_mig_object( - ipc_port_t port, - const MIGIID *iid); + ipc_port_t port, + const MIGIID *iid); -boolean_t mig_object_no_senders( - ipc_port_t port, - mach_port_mscount_t mscount); +extern void mig_object_no_senders( + ipc_port_t port); #endif /* MACH_KERNEL_PRIVATE */ -#endif /* _KERN_IPC_MIG_H_ */ +#endif /* _KERN_IPC_MIG_H_ */