xnu-2422.110.17.tar.gz

[apple/xnu.git] / iokit / IOKit / pwr_mgt / IOPMinformeeList.h

diff --git a/iokit/IOKit/pwr_mgt/IOPMinformeeList.h b/iokit/IOKit/pwr_mgt/IOPMinformeeList.h
index d014d1c2e8fdbd9279a07322575c8cf2b00d41a4..8efd4a65448d11799000451821c90d0460f9a7f5 100644 (file)
--- a/iokit/IOKit/pwr_mgt/IOPMinformeeList.h
+++ b/iokit/IOKit/pwr_mgt/IOPMinformeeList.h
@@ -1,16 +1,19 @@
 /*
  * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
  *
- * @APPLE_LICENSE_HEADER_START@
- * 
- * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
+ * @APPLE_OSREFERENCE_LICENSE_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. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ * 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.
+ * 
+ * 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
@@ -20,9 +23,10 @@
  * Please see the License for the specific language governing rights and
  * limitations under the License.
  * 
- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  */
 #include <libkern/c++/OSObject.h>
+#include <IOKit/IOLocks.h>
 #include <IOKit/IOReturn.h>
 
 class IOPMinformee;
@@ -31,27 +35,33 @@ class IOService;
 class IOPMinformeeList : public OSObject
 {
 OSDeclareDefaultStructors(IOPMinformeeList)
+    friend class IOPMinformee;
 
 private:
-IOPMinformee *  firstItem;             // pointer to first informee in the list
-unsigned long  length;                 // how many informees are in the list
-
+    // pointer to first informee in the list
+    IOPMinformee       *firstItem;
+    // how many informees are in the list
+    unsigned long       length;
 
 public:
-void initialize ( void );
-
-IOReturn addToList ( IOPMinformee *   newInformee );
-
-IOPMinformee * firstInList ( void );
-
-IOPMinformee * nextInList ( IOPMinformee * currentItem );
-
-unsigned long numberOfItems ( void );
+    void initialize ( void );
+    void free ( void );
 
-IOPMinformee * findItem ( IOService * driverOrChild );
+    unsigned long numberOfItems ( void );
 
-IOReturn removeFromList ( IOService * theItem );
+    IOPMinformee *appendNewInformee( IOService * newObject );
+    
+    // OBSOLETE
+    // do not use addToList(); Use appendNewInformee() instead
+    IOReturn addToList ( IOPMinformee *   newInformee );
+    IOReturn removeFromList ( IOService * theItem );
+    
+    IOPMinformee * firstInList ( void );
+    IOPMinformee * nextInList ( IOPMinformee * currentItem );
+    
+    IOPMinformee * findItem ( IOService * driverOrChild );        
 
-void free ( void );
+    // This lock must be held while modifying list or length
+    static IORecursiveLock * getSharedRecursiveLock( void );
 };