X-Git-Url: https://git.saurik.com/apple/xnu.git/blobdiff_plain/8ad349bb6ed4a0be06e34c92be0d98b92e078db4..f427ee49d309d8fc33ebf3042c3a775f2f530ded:/osfmk/kern/ipc_tt.h?ds=sidebyside diff --git a/osfmk/kern/ipc_tt.h b/osfmk/kern/ipc_tt.h index 99c1e507e..2ebe7e289 100644 --- a/osfmk/kern/ipc_tt.h +++ b/osfmk/kern/ipc_tt.h @@ -1,64 +1,62 @@ /* * Copyright (c) 2000-2004 Apple Computer, Inc. All rights reserved. * - * @APPLE_LICENSE_OSREFERENCE_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. + * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ * - * Please obtain a copy of the License at - * http://www.opensource.apple.com/apsl/ and read it before using this - * file. + * 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. * - * 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, QUIET ENJOYMENT OR NON-INFRINGEMENT. - * Please see the License for the specific language governing rights and + * 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, QUIET ENJOYMENT OR NON-INFRINGEMENT. + * Please see the License for the specific language governing rights and * limitations under the License. * - * @APPLE_LICENSE_OSREFERENCE_HEADER_END@ + * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ */ /* * @OSF_COPYRIGHT@ */ -/* +/* * Mach Operating System * Copyright (c) 1991,1990,1989,1988,1987 Carnegie Mellon University * All Rights Reserved. - * + * * Permission to use, copy, modify and distribute this software and its * documentation is hereby granted, provided that both the copyright * notice and this permission notice appear in all copies of the * software, derivative works or modified versions, and any portions * thereof, and that both notices appear in supporting documentation. - * + * * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS" * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. - * + * * Carnegie Mellon requests users of this software to return to - * + * * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU * School of Computer Science * Carnegie Mellon University * Pittsburgh PA 15213-3890 - * + * * any improvements or extensions that they make and grant Carnegie Mellon * the rights to redistribute these changes. */ /* */ -#ifndef _KERN_IPC_TT_H_ +#ifndef _KERN_IPC_TT_H_ #define _KERN_IPC_TT_H_ #include @@ -76,83 +74,184 @@ /* Initialize a task's IPC state */ extern void ipc_task_init( - task_t task, - task_t parent); + task_t task, + task_t parent); /* Enable a task for IPC access */ extern void ipc_task_enable( - task_t task); + task_t task); /* Disable IPC access to a task */ extern void ipc_task_disable( - task_t task); + task_t task); /* Clear out a task's IPC state */ extern void ipc_task_reset( - task_t task); + task_t task); /* Clean up and destroy a task's IPC state */ extern void ipc_task_terminate( - task_t task); + task_t task); /* Initialize a thread's IPC state */ extern void ipc_thread_init( - thread_t thread); + thread_t thread); + +extern void ipc_thread_init_exc_actions( + thread_t thread); + +extern void ipc_thread_destroy_exc_actions( + thread_t thread); /* Disable IPC access to a thread */ extern void ipc_thread_disable( - thread_t thread); + thread_t thread); /* Clean up and destroy a thread's IPC state */ extern void ipc_thread_terminate( - thread_t thread); + thread_t thread); + +/* Clear out a thread's IPC state */ +extern void ipc_thread_reset( + thread_t thread); /* Return a send right for the task's user-visible self port */ extern ipc_port_t retrieve_task_self_fast( - task_t task); + task_t task); /* Return a send right for the thread's user-visible self port */ extern ipc_port_t retrieve_thread_self_fast( - thread_t thread); + thread_t thread); + +/* Check port's type, and convert to correct task type */ +extern task_t convert_port_to_task_check_type( + ipc_port_t port, + ipc_kobject_type_t *kotype, + mach_task_flavor_t at_most, + int eval_check); + +/* Check port's type, and convert to correct thread type */ +extern thread_t convert_port_to_thread_check_type( + ipc_port_t port, + ipc_kobject_type_t *kotype, + mach_thread_flavor_t at_most, + int eval_check); + +/* Check port's type, and convert to correct ipc_space type */ +extern ipc_space_t convert_port_to_space_check_type( + ipc_port_t port, + ipc_kobject_type_t *kotype, + mach_task_flavor_t at_most, + int eval_check); + +/* Convert from a port to a task name */ +extern task_name_t convert_port_to_task_name( + ipc_port_t port); + +/* Convert from a port to a task for task_policy_set(). */ +extern task_policy_set_t convert_port_to_task_policy_set( + ipc_port_t port); + +/* Convert from a port to a task for task_policy_get(). */ +extern task_policy_get_t convert_port_to_task_policy_get( + ipc_port_t port); + +/* Convert from a port to a task inspect */ +extern task_inspect_t convert_port_to_task_inspect( + ipc_port_t port); + +/* Convert from a port to a task read */ +extern task_read_t convert_port_to_task_read( + ipc_port_t port); /* Convert from a port to a task */ extern task_t convert_port_to_task( - ipc_port_t port); + ipc_port_t port); + +extern task_t +convert_port_to_task_with_exec_token( + ipc_port_t port, + uint32_t *exec_token, + boolean_t eval); extern task_t port_name_to_task( mach_port_name_t name); +extern task_read_t port_name_to_task_read( + mach_port_name_t name); + +extern task_read_t port_name_to_task_read_no_eval( + mach_port_name_t name); + +extern task_inspect_t port_name_to_task_inspect( + mach_port_name_t name); + +extern task_t port_name_to_task_name( + mach_port_name_t name); + +extern host_t port_name_to_host( + mach_port_name_t name); + extern boolean_t ref_task_port_locked( ipc_port_t port, task_t *ptask); /* Convert from a port to a space */ extern ipc_space_t convert_port_to_space( - ipc_port_t port); + ipc_port_t port); + +/* Convert from a port to a space inspection right */ +extern ipc_space_read_t convert_port_to_space_read( + ipc_port_t port); + +/* Convert from a port to a space inspection right */ +extern ipc_space_inspect_t convert_port_to_space_inspect( + ipc_port_t port); extern boolean_t ref_space_port_locked( ipc_port_t port, ipc_space_t *pspace); /* Convert from a port to a map */ extern vm_map_t convert_port_to_map( - ipc_port_t port); + ipc_port_t port); + +/* Convert from a port to a map read */ +extern vm_map_read_t convert_port_to_map_read( + ipc_port_t port); + +/* Convert from a port to a map inspect */ +extern vm_map_inspect_t convert_port_to_map_inspect( + ipc_port_t port); /* Convert from a port to a thread */ -extern thread_t convert_port_to_thread( - ipc_port_t port); +extern thread_t convert_port_to_thread( + ipc_port_t port); + +/* Convert from a port to a thread inspect */ +extern thread_inspect_t convert_port_to_thread_inspect( + ipc_port_t port); -extern thread_t port_name_to_thread( - mach_port_name_t port_name); +/* Convert from a port to a thread read */ +extern thread_read_t convert_port_to_thread_read( + ipc_port_t port); -/* Convert from a task to a port */ -extern ipc_port_t convert_task_to_port( - task_t task); +__options_decl(port_to_thread_options_t, uint32_t, { + PORT_TO_THREAD_NONE = 0x0000, + PORT_TO_THREAD_IN_CURRENT_TASK = 0x0001, + PORT_TO_THREAD_NOT_CURRENT_THREAD = 0x0002, +}); -/* Convert from a thread to a port */ -extern ipc_port_t convert_thread_to_port( - thread_t thread); +extern thread_t port_name_to_thread( + mach_port_name_t port_name, + port_to_thread_options_t options); /* Deallocate a space ref produced by convert_port_to_space */ extern void space_deallocate( - ipc_space_t space); + ipc_space_t space); + +extern void space_read_deallocate( + ipc_space_read_t space); + +extern void space_inspect_deallocate( + ipc_space_inspect_t space); -#endif /* _KERN_IPC_TT_H_ */ +#endif /* _KERN_IPC_TT_H_ */