xnu-1504.7.4.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 608a93d4a1c01bc53e46f735a9465e68fef1e532..8efd4a65448d11799000451821c90d0460f9a7f5 100644 (file)
--- a/iokit/IOKit/pwr_mgt/IOPMinformeeList.h
+++ b/iokit/IOKit/pwr_mgt/IOPMinformeeList.h
@@ -1,25 +1,32 @@
 /*
  * Copyright (c) 1998-2000 Apple Computer, 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@
  */
 #include <libkern/c++/OSObject.h>
+#include <IOKit/IOLocks.h>
 #include <IOKit/IOReturn.h>
 
 class IOPMinformee;
@@ -28,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 );
 };