X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/d7e50217d7adf6e52786a38bcaa4cd698cb9a79e..cb3231590a3c94ab4375e2228bd5e86b0cf1ad7e:/osfmk/kern/ipc_mig.h?ds=sidebyside diff --git a/osfmk/kern/ipc_mig.h b/osfmk/kern/ipc_mig.h index 637b78fad..a4fad67e1 100644 --- a/osfmk/kern/ipc_mig.h +++ b/osfmk/kern/ipc_mig.h @@ -1,17 +1,20 @@ /* - * Copyright (c) 2000 Apple Computer, Inc. All rights reserved. + * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved. + * + * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ * - * @APPLE_LICENSE_HEADER_START@ - * - * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved. - * * 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. Please obtain a copy of the License at - * http://www.opensource.apple.com/apsl/ and read it before using this - * file. - * + * 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, @@ -19,18 +22,25 @@ * 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_LICENSE_HEADER_END@ + * + * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ */ /* * @OSF_COPYRIGHT@ */ -#ifndef _IPC_MIG_H_ -#define _IPC_MIG_H_ +#ifndef _KERN_IPC_MIG_H_ +#define _KERN_IPC_MIG_H_ #include +#include #include +#include + +#include + +#ifdef XNU_KERNEL_PRIVATE + #include /* @@ -39,110 +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 */ + +__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_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 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 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 extern void mach_msg_receive_continue(void); -#include +/* Initialize kernel server dispatch table */ +extern void mig_init(void); -#ifdef __APPLE_API_EVOLVING /* * 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 { - 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; @@ -153,10 +212,33 @@ typedef struct mig_object { * chain and deliver the appropriate notification. */ typedef struct mig_notify_object { - 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; -#endif /* __APPLE_API_EVOLVING */ +extern kern_return_t mig_object_init( + mig_object_t mig_object, + const IMIGObject *interface); + +extern void mig_object_destroy( + mig_object_t mig_object); + +extern void mig_object_reference( + mig_object_t mig_object); + +extern void mig_object_deallocate( + mig_object_t mig_object); + +extern ipc_port_t convert_mig_object_to_port( + mig_object_t mig_object); + +extern mig_object_t convert_port_to_mig_object( + ipc_port_t port, + const MIGIID *iid); + +extern void mig_object_no_senders( + ipc_port_t port); + +#endif /* MACH_KERNEL_PRIVATE */ -#endif /* _IPC_MIG_H_ */ +#endif /* _KERN_IPC_MIG_H_ */