iokit/Kernel/IOServicePrivate.h

   1 /*
   2  * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. The rights granted to you under the License
  10  * may not be used to create, or enable the creation or redistribution of,
  11  * unlawful or unlicensed copies of an Apple operating system, or to
  12  * circumvent, violate, or enable the circumvention or violation of, any
  13  * terms of an Apple operating system software license agreement.
  14  *
  15  * Please obtain a copy of the License at
  16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  17  *
  18  * The Original Code and all software distributed under the License are
  19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23  * Please see the License for the specific language governing rights and
  24  * limitations under the License.
  25  *
  26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27  */
  28 /*
  29  * Copyright (c) 1999 Apple Computer, Inc.  All rights reserved.
  30  *
  31  * HISTORY
  32  *
  33  */
  34
  35
  36 #ifndef _IOKIT_IOSERVICEPRIVATE_H
  37 #define _IOKIT_IOSERVICEPRIVATE_H
  38
  39 // options for getExistingServices()
  40 enum {
  41         kIONotifyOnce             = 0x00000001,
  42         kIOServiceExistingSet     = 0x00000002,
  43         kIOServiceChangesOK       = 0x00000004,
  44         kIOServiceInternalDone    = 0x00000008,
  45         kIOServiceClassDone       = 0x00000010,
  46 };
  47
  48 // masks for __state[1]
  49 enum {
  50         kIOServiceBusyStateMask     = 0x000003ff,
  51         kIOServiceBusyMax           = 1023,
  52         kIOServiceNeedConfigState   = 0x80000000,
  53         kIOServiceSynchronousState  = 0x40000000,
  54         kIOServiceModuleStallState  = 0x20000000,
  55         kIOServiceBusyWaiterState   = 0x10000000,
  56
  57         kIOServiceSyncPubState      = 0x08000000,
  58         kIOServiceConfigState       = 0x04000000,
  59         kIOServiceStartState        = 0x02000000,
  60         kIOServiceTermPhase2State   = 0x01000000,
  61         kIOServiceTermPhase3State   = 0x00800000,
  62         kIOServiceTermPhase1State   = 0x00400000,
  63         kIOServiceTerm1WaiterState  = 0x00200000,
  64         kIOServiceRecursing         = 0x00100000,
  65         kIOServiceNeedWillTerminate = 0x00080000,
  66         kIOServiceWaitDetachState   = 0x00040000,
  67         kIOServiceConfigRunning     = 0x00020000,
  68         kIOServiceFinalized         = 0x00010000,
  69 };
  70
  71 // notify state
  72 enum {
  73         kIOServiceNotifyEnable      = 0x00000001,
  74         kIOServiceNotifyWaiter      = 0x00000002,
  75         kIOServiceNotifyBlock       = 0x00000004
  76 };
  77
  78 struct _IOServiceNotifierInvocation {
  79         IOThread            thread;
  80         queue_chain_t       link;
  81 };
  82
  83 class _IOServiceNotifier : public IONotifier
  84 {
  85         friend class IOService;
  86
  87         OSDeclareDefaultStructors(_IOServiceNotifier)
  88
  89 public:
  90         OSOrderedSet *                      whence;
  91
  92         OSDictionary *                      matching;
  93         const OSSymbol *                    type;
  94         IOServiceMatchingNotificationHandler handler;
  95         IOServiceNotificationHandler        compatHandler;
  96         void *                              target;
  97         void *                              ref;
  98         SInt32                              priority;
  99         queue_head_t                        handlerInvocations;
 100         IOOptionBits                        state;
 101
 102         virtual void free() APPLE_KEXT_OVERRIDE;
 103         virtual void remove() APPLE_KEXT_OVERRIDE;
 104         virtual bool disable() APPLE_KEXT_OVERRIDE;
 105         virtual void enable( bool was ) APPLE_KEXT_OVERRIDE;
 106         virtual void wait();
 107 };
 108
 109 class _IOServiceInterestNotifier : public IONotifier
 110 {
 111         friend class IOService;
 112
 113         OSDeclareDefaultStructors(_IOServiceInterestNotifier)
 114
 115 public:
 116         queue_chain_t               chain;
 117
 118         IOServiceInterestHandler    handler;
 119         void *                      target;
 120         void *                      ref;
 121         queue_head_t                handlerInvocations;
 122         IOOptionBits                state;
 123
 124         virtual void free() APPLE_KEXT_OVERRIDE;
 125         virtual void remove() APPLE_KEXT_OVERRIDE;
 126         virtual bool disable() APPLE_KEXT_OVERRIDE;
 127         virtual void enable( bool was ) APPLE_KEXT_OVERRIDE;
 128         virtual void wait();
 129         virtual bool init() APPLE_KEXT_OVERRIDE;
 130 };
 131
 132 class _IOServiceNullNotifier : public IONotifier
 133 {
 134         OSDeclareDefaultStructors(_IOServiceNullNotifier)
 135
 136 public:
 137         virtual void taggedRetain(const void *tag) const APPLE_KEXT_OVERRIDE;
 138         virtual void taggedRelease(const void *tag, const int when) const APPLE_KEXT_OVERRIDE;
 139         virtual void free() APPLE_KEXT_OVERRIDE;
 140         virtual void remove() APPLE_KEXT_OVERRIDE;
 141         virtual bool disable() APPLE_KEXT_OVERRIDE;
 142         virtual void enable( bool was ) APPLE_KEXT_OVERRIDE;
 143         virtual void wait();
 144 };
 145
 146 class _IOConfigThread : public OSObject
 147 {
 148         friend class IOService;
 149
 150         OSDeclareDefaultStructors(_IOConfigThread)
 151
 152 public:
 153         virtual void free() APPLE_KEXT_OVERRIDE;
 154
 155         static void configThread( void );
 156         static void main( void * arg, wait_result_t result );
 157 };
 158
 159 enum {
 160         kMaxConfigThreads       = CONFIG_MAX_THREADS,
 161 };
 162
 163 enum {
 164         kMatchNubJob        = 10,
 165 };
 166
 167 class _IOServiceJob : public OSObject
 168 {
 169         friend class IOService;
 170
 171         OSDeclareDefaultStructors(_IOServiceJob)
 172
 173 public:
 174         int                 type;
 175         IOService *         nub;
 176         IOOptionBits        options;
 177
 178         static _IOServiceJob * startJob( IOService * nub, int type,
 179             IOOptionBits options = 0 );
 180         static void pingConfig( class _IOServiceJob * job );
 181 };
 182
 183 class IOResources : public IOService
 184 {
 185         friend class IOService;
 186
 187         OSDeclareDefaultStructors(IOResources)
 188
 189 public:
 190         static IOService * resources( void );
 191         virtual bool init( OSDictionary * dictionary = 0 ) APPLE_KEXT_OVERRIDE;
 192         virtual IOReturn newUserClient(task_t owningTask, void * securityID,
 193             UInt32 type, OSDictionary * properties,
 194             IOUserClient ** handler) APPLE_KEXT_OVERRIDE;
 195         virtual IOWorkLoop * getWorkLoop() const APPLE_KEXT_OVERRIDE;
 196         virtual bool matchPropertyTable( OSDictionary * table ) APPLE_KEXT_OVERRIDE;
 197         virtual IOReturn setProperties( OSObject * properties ) APPLE_KEXT_OVERRIDE;
 198 };
 199
 200 class _IOOpenServiceIterator : public OSIterator
 201 {
 202         friend class IOService;
 203
 204         OSDeclareDefaultStructors(_IOOpenServiceIterator)
 205
 206         OSIterator *        iter;
 207         const IOService *   client;
 208         const IOService *   provider;
 209         IOService *         last;
 210
 211 public:
 212         static OSIterator * iterator(LIBKERN_CONSUMED OSIterator * _iter,
 213             const IOService * client,
 214             const IOService * provider );
 215         virtual void free() APPLE_KEXT_OVERRIDE;
 216         virtual void reset() APPLE_KEXT_OVERRIDE;
 217         virtual bool isValid() APPLE_KEXT_OVERRIDE;
 218         virtual OSObject * getNextObject() APPLE_KEXT_OVERRIDE;
 219 };
 220
 221 extern const OSSymbol * gIOConsoleUsersKey;
 222 extern const OSSymbol * gIOConsoleSessionUIDKey;
 223 extern const OSSymbol * gIOConsoleSessionAuditIDKey;
 224 extern const OSSymbol * gIOConsoleSessionOnConsoleKey;
 225 extern const OSSymbol * gIOConsoleSessionSecureInputPIDKey;
 226
 227
 228 #define _interruptSourcesPrivate(service)   \
 229     ((IOInterruptSourcePrivate *)(&(service)->_interruptSources[(service)->_numInterruptSources]))
 230
 231 #define sizeofAllIOInterruptSource          \
 232     (sizeof(IOInterruptSourcePrivate) + sizeof(IOInterruptSource))
 233
 234 #endif /* ! _IOKIT_IOSERVICEPRIVATE_H */