Return to subsystem.h CVS log

Up to [Apple XNU] / XNU / osfmk / kern

Annotation of XNU/osfmk/kern/subsystem.h, revision 1.1

1.1     ! root        1: /*
        !             2:  * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
        !             3:  *
        !             4:  * @APPLE_LICENSE_HEADER_START@
        !             5:  * 
        !             6:  * The contents of this file constitute Original Code as defined in and
        !             7:  * are subject to the Apple Public Source License Version 1.1 (the
        !             8:  * "License").  You may not use this file except in compliance with the
        !             9:  * License.  Please obtain a copy of the License at
        !            10:  * http://www.apple.com/publicsource and read it before using this file.
        !            11:  * 
        !            12:  * This Original Code and all software distributed under the License are
        !            13:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
        !            14:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
        !            15:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
        !            16:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
        !            17:  * License for the specific language governing rights and limitations
        !            18:  * under the License.
        !            19:  * 
        !            20:  * @APPLE_LICENSE_HEADER_END@
        !            21:  */
        !            22: /*
        !            23:  * @OSF_COPYRIGHT@
        !            24:  */
        !            25: /*
        !            26:  *     Definitions for RPC subsystems.
        !            27:  */
        !            28: 
        !            29: #ifndef        _IPC_IPC_SUBSYSTEM_H_
        !            30: #define _IPC_IPC_SUBSYSTEM_H_
        !            31: 
        !            32: #include <mach/kern_return.h>
        !            33: #include <mach/mach_types.h>
        !            34: #include <mach/std_types.h>
        !            35: #include <mach/rpc.h>
        !            36: 
        !            37: #ifdef MACH_KERNEL_PRIVATE
        !            38: #include <kern/kern_types.h>
        !            39: #include <kern/lock.h>
        !            40: 
        !            41: #define subsystem_lock_init(subsys) \
        !            42:        simple_lock_init(&(subsys)->lock, ETAP_MISC_RPC_SUBSYS)
        !            43: #define subsystem_lock(subsys)         simple_lock(&(subsys)->lock)
        !            44: #define subsystem_unlock(subsys)       simple_unlock(&(subsys)->lock)
        !            45: 
        !            46: /*
        !            47:  *     A subsystem describes a set of server routines that can be invoked by
        !            48:  *     mach_rpc() on the ports that are registered with the subsystem.
        !            49:  *     See struct rpc_subsystem in mach/rpc.h, for more details.
        !            50:  */
        !            51: struct subsystem {
        !            52:        /* Synchronization/destruction information */
        !            53:        decl_simple_lock_data(,lock)    /* Subsystem lock                    */
        !            54:        int             ref_count;      /* Number of references to me        */
        !            55:        vm_size_t       size;           /* Number of bytes in this structure */
        !            56:                                        /* including the variable length     */
        !            57:                                        /* user_susbystem description        */
        !            58:         /* Task information */
        !            59:         task_t          task;           /* Task to which I belong           */
        !            60:         queue_chain_t   subsystem_list; /* list of subsystems in task       */
        !            61: 
        !            62:        /* IPC stuff: */
        !            63:        struct ipc_port *ipc_self;      /* Port naming this subsystem        */
        !            64: 
        !            65:        struct rpc_subsystem user;      /* MIG-generated subsystem descr     */
        !            66: };
        !            67: 
        !            68: extern void            subsystem_init(void);
        !            69: 
        !            70: #endif /* MACH_KERNEL_PRIVATE */
        !            71: 
        !            72: /* Subsystem create, with 1 reference. */
        !            73: extern kern_return_t   mach_subsystem_create(
        !            74:                                task_t                  parent_task,
        !            75:                                user_subsystem_t        user_subsys,
        !            76:                                mach_msg_type_number_t  user_subsysCount,
        !            77:                                subsystem_t             *subsystem);
        !            78: 
        !            79: /* Take additional reference on subsystem (make sure it doesn't go away) */
        !            80: extern void            subsystem_reference(
        !            81:                                subsystem_t     subsystem);
        !            82: 
        !            83: /* Remove one reference on subsystem (it is destroyed if 0 refs remain) */
        !            84: extern void            subsystem_deallocate(
        !            85:                                subsystem_t     subsystem);
        !            86: 
        !            87: #if    MACH_KDB
        !            88: extern void            subsystem_print(
        !            89:                                subsystem_t     subsystem);
        !            90: #endif /* MACH_KDB */
        !            91: 
        !            92: #endif /* _IPC_IPC_SUBSYSTEM_H_ */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.