xnu-1699.26.8.tar.gz

[apple/xnu.git] / osfmk / mach / host_priv.defs

diff --git a/osfmk/mach/host_priv.defs b/osfmk/mach/host_priv.defs
index 244c387531d0b917a3bd5cdcf2934f54dafb7ab7..3be39868b9bba67accbf65f72637ebe32e79d47d 100644 (file)
--- a/osfmk/mach/host_priv.defs
+++ b/osfmk/mach/host_priv.defs
@@ -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,
  * 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@
  */
 /*
  * @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;
                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;
                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
 
 /*
  *     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;
                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(
 
 /*
  *     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(
  *     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;
 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.
 
 /*
  *     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.
  */
  *     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);
 
 /*
         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;
  */
 routine host_set_special_port(
                 host_priv       : host_priv_t;


@@ -273,12 +279,18 @@ routine host_load_symbol_table(
                symtab          : pointer_t);
 
 /*
                symtab          : pointer_t);
 
 /*

- *     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;
                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
 
 /*
  * JMM - Keep all processor_set related items at the end for easy


@@ -298,6 +310,12 @@ routine host_processor_set_priv(
                host_priv       : host_priv_t;
                set_name        : processor_set_name_t;
        out     set             : processor_set_t);
                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
 /*
  *     Set the dynamic_pager control port. Other entities
  *     can request a send right to this port to talk with


@@ -341,3 +359,22 @@ routine host_get_UNDServer(
                host            : host_priv_t;
        out     server          : UNDServerRef);
 
                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 : */