1 /* 2 * Copyright (c) 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 /* IOArray.h created by rsulack on Thu 11-Sep-1997 */ 29 30 #include <libkern/OSDebug.h> 31 32 #include <libkern/c++/OSCollection.h> 33 #include <libkern/c++/OSDictionary.h> 34 35 #include <IOKit/IOKitDebug.h> 36 37 #define super OSObject 38 39 OSDefineMetaClassAndAbstractStructors(OSCollection, OSObject) 40 41 42 OSMetaClassDefineReservedUsed(OSCollection, 0); 43 OSMetaClassDefineReservedUsed(OSCollection, 1); 44 OSMetaClassDefineReservedUnused(OSCollection, 2); 45 OSMetaClassDefineReservedUnused(OSCollection, 3); 46 OSMetaClassDefineReservedUnused(OSCollection, 4); 47 OSMetaClassDefineReservedUnused(OSCollection, 5); 48 OSMetaClassDefineReservedUnused(OSCollection, 6); 49 OSMetaClassDefineReservedUnused(OSCollection, 7); 50 51 bool OSCollection::init() 52 { 53 if (!super::init()) 54 return false; 55 56 updateStamp = 0; 57 58 return true; 59 } 60 61 void OSCollection::haveUpdated() 62 { 63 if (fOptions & kImmutable) 64 { 65 if (!(gIOKitDebug & kOSRegistryModsMode)) 66 { 67 panic("Trying to change a collection in the registry"); 68 } 69 else 70 { 71 OSReportWithBacktrace("Trying to change a collection in the registry"); 72 } 73 } 74 updateStamp++; 75 } 76 77 unsigned OSCollection::setOptions(unsigned options, unsigned mask, void *) 78 { 79 unsigned old = fOptions; 80 81 if (mask) 82 fOptions = (old & ~mask) | (options & mask); 83 84 return old; 85 } 86 87 OSCollection * OSCollection::copyCollection(OSDictionary *cycleDict) 88 { 89 if (cycleDict) { 90 OSObject *obj = cycleDict->getObject((const OSSymbol *) this); 91 if (obj) 92 obj->retain(); 93 94 return reinterpret_cast<OSCollection *>(obj); 95 } 96 else { 97 // If we are here it means that there is a collection subclass that 98 // hasn't overridden the copyCollection method. In which case just 99 // return a reference to ourselves. 100 // Hopefully this collection will not be inserted into the registry 101 retain(); 102 return this; 103 } 104 } 105 106 bool OSCollection::iterateObjects(void * refcon, bool (*callback)(void * refcon, OSObject * object)) 107 { 108 uint64_t iteratorStore[2]; 109 unsigned int initialUpdateStamp; 110 bool done; 111 112 assert(iteratorSize() < sizeof(iteratorStore)); 113 114 if (!initIterator(&iteratorStore[0])) return (false); 115 116 initialUpdateStamp = updateStamp; 117 done = false; 118 do 119 { 120 OSObject * object; 121 if (!getNextObjectForIterator(&iteratorStore[0], &object)) break; 122 done = callback(refcon, object); 123 } 124 while (!done && (initialUpdateStamp == updateStamp)); 125 126 return initialUpdateStamp == updateStamp; 127 } 128 129 static bool OSCollectionIterateObjectsBlock(void * refcon, OSObject * object) 130 { 131 bool (^block)(OSObject * object) = (typeof(block)) refcon; 132 return (block(object)); 133 } 134 135 bool OSCollection::iterateObjects(bool (^block)(OSObject * object)) 136 { 137 return (iterateObjects((void *) block, OSCollectionIterateObjectsBlock)); 138 } 139