]> git.saurik.com Git - apple/xnu.git/blobdiff - osfmk/mach/host_priv.defs
xnu-3247.10.11.tar.gz
[apple/xnu.git] / osfmk / mach / host_priv.defs
index 244c387531d0b917a3bd5cdcf2934f54dafb7ab7..ac4997b221edd9df28d16a5ce0ff1b087cca4d0e 100644 (file)
@@ -1,23 +1,29 @@
 /*
- * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000-2004 Apple Inc. All rights reserved.
  *
- * @APPLE_LICENSE_HEADER_START@
+ * @APPLE_OSREFERENCE_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 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.
  * 
- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * 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.
+ * 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@
@@ -107,7 +113,7 @@ routine host_default_memory_manager(
                host_priv       : host_priv_t;
        inout   default_manager : memory_object_default_t = 
                                        MACH_MSG_TYPE_MAKE_SEND;
-               cluster_size    : vm_size_t);
+               cluster_size    : memory_object_cluster_size_t);
 
 
 /*
@@ -122,7 +128,7 @@ routine     vm_wire(
                task            : vm_map_t;
                address         : vm_address_t;
                size            : vm_size_t;
-               access          : vm_prot_t);
+               desired_access  : vm_prot_t);
 
 /*
  *     Specify that the target thread must always be able
@@ -156,18 +162,18 @@ routine   vm_allocate_cpm(
                task            : vm_map_t;
        inout   address         : vm_address_t;
                size            : vm_size_t;
-               anywhere        : boolean_t);
+               flags           : int);
 
 /*
  *     Get list of processors on this host.
  */
 routine host_processors(
-               host_priv       : host_priv_t;
-       out     processor_list  : processor_array_t);
+               host_priv               : host_priv_t;
+       out     out_processor_list      : processor_array_t);
 
 
 /*
- *     Get control port for a processor set.
+ *     Get control port for a system-wide clock.
  *     Privileged.
  */
 routine host_get_clock_control(
@@ -177,10 +183,10 @@ routine host_get_clock_control(
 
 
 /*
- *     kernel module interface
- * 
- *     see mach/kmod.h:
+ * kernel module interface (obsolete as of SnowLeopard)
+ * see mach/kmod.h
  */
+/* kmod_ MIG calls now return KERN_NOT_SUPPORTED on PPC/i386/x86_64. */
 routine kmod_create(
                host_priv       : host_priv_t;
                info            : vm_address_t;
@@ -198,7 +204,7 @@ routine     kmod_control(
 
 /*
  *     Get a given special port for a given node.
- *     Norma special ports are defined in norma_special_ports.h;
+ *     Special ports are defined in host_special_ports.h;
  *     examples include the master device port.
  *     There are a limited number of slots available for system servers.
  */
@@ -209,8 +215,8 @@ routine host_get_special_port(
         out     port            : mach_port_t);
 
 /*
- *     Set a given special port for a given node.
- *     See norma_get_special_port.
+ *     Set a given special port for the local node.
+ *     See host_get_special_port.
  */
 routine host_set_special_port(
                 host_priv       : host_priv_t;
@@ -259,26 +265,21 @@ routine   host_swap_exception_ports(
          out   old_behaviors   : exception_behavior_array_t, SameCount;
          out   old_flavors     : exception_flavor_array_t, SameCount);
 
-/*
- *     Loads a symbol table for an external file into the kernel debugger.
- *     The symbol table data is an array of characters.  It is assumed that
- *     the caller and the kernel debugger agree on its format.
- *      This call is only supported in MACH_DEBUG and MACH_KDB kernels,
- *      otherwise KERN_FAILURE is returned.
- */
-routine host_load_symbol_table(
-               host            : host_priv_t;
-               task            : task_t;
-               name            : symtab_name_t;
-               symtab          : pointer_t);
+skip; /* old host_load_symbol_table */
 
 /*
- *     Make the target task swappable or unswappable.
+ *     Specify that the range of the virtual address space
+ *     of the target task must not cause page faults for
+ *     the indicated accesses.
+ *
+ *     [ To unwire the pages, specify VM_PROT_NONE. ]
  */
-routine task_swappable(
+routine        mach_vm_wire(
                host_priv       : host_priv_t;
-               target_task     : task_t;
-               make_swappable  : boolean_t);
+               task            : vm_map_t;
+               address         : mach_vm_address_t;
+               size            : mach_vm_size_t;
+               desired_access  : vm_prot_t);
 
 /*
  * JMM - Keep all processor_set related items at the end for easy
@@ -298,6 +299,12 @@ routine host_processor_set_priv(
                host_priv       : host_priv_t;
                set_name        : processor_set_name_t;
        out     set             : processor_set_t);
+
+/************************** Warning *************************************/
+/*       The following routines are going away in a future release     */
+/*     use the appropriate variant of host_set_special_port instead    */
+/************************************************************************/
 /*
  *     Set the dynamic_pager control port. Other entities
  *     can request a send right to this port to talk with
@@ -341,3 +348,22 @@ routine host_get_UNDServer(
                host            : host_priv_t;
        out     server          : UNDServerRef);
 
+/*
+ * Perform an operation with a kernel extension, on the kext loading system,
+ * or request information about loaded kexts or the state of the kext loading
+ * system.
+ * Active operations (load, unload, disable/enable) require host_priv/root access.
+ * Info retrieval does not.
+ *
+ * WARNING: THIS ROUTINE IS PRIVATE TO THE KEXT-MANAGEMENT STACK AND IS
+ * SUBJECT TO CHANGE AT ANY TIME.
+ */
+routine kext_request(
+        host_priv      : host_priv_t;
+    in  user_log_flags : uint32_t;
+    in  request_data   : pointer_t;
+    out response_data  : pointer_t;
+    out log_data       : pointer_t;
+    out op_result      : kern_return_t);
+
+/* vim: set ft=c : */