iokit/IOKit/IOCatalogue.h

52     @abstract In-kernel database for IOKit driver personalities.
53     @discussion The IOCatalogue is a database which contains all IOKit driver personalities.  IOService uses this resource when matching devices to their associated drivers.
62     OSDictionary           * personalities;
69         @abstract Creates and initializes the database object and poputates it with in-kernel driver personalities.
76         @param initArray  The initial array of driver personalities to populate the database.
90         @param generationCount  Returns a reference to the generation count of the database. The generation count increases only when personalities are added to the database *and* IOService matching has been initiated.
91         @result Returns an ordered set of driver personalities ranked on probe-scores.  The ordered set must be released by the receiver.
97         @abstract A more general purpose interface which allows one to retreive driver personalities based the intersection of the 'matching' dictionary and the personality's own property list.
98         @param matching  A dictionary containing only keys and values which are to be used for matching. For example, a matching dictionary containing 'IOProviderClass'='IOPCIDevice' will return all personalities with an IOProviderClass key and a value of IOPCIDevice.
99         @param generationCount  Returns a reference to the current generation of the database. The generation count increases only when personalities are added to the database *and* IOService matching has been initiated.
100         @result Returns an ordered set of driver personalities ranked on probe-scores. The ordered set must be released by the receiver.
106         @abstract Adds an array of driver personalities to the database.
107         @param array Array of driver personalities to be added to the database.
108         @param doNubMatchng Start matching process after personalities have been added.
115         @abstract Remove driver personalities from the database based on matching information provided.
116         @param matching  A dictionary whose keys and values are used for matching personalities in the database.  For example, a matching dictionary containing a 'IOProviderClass' key with the value 'IOPCIDevice' will remove all personalities which have the key 'IOProviderClass' equal to 'IOPCIDevice'.
117         @param doNubMatchng Start matching process after personalities have been removed.  Matching criteria is based on IOProviderClass of those personalities which were removed.  This is to allow drivers which haven't been matched to match against NUB's which were blocked by the previous personalities.
169         @param matching  A dictionary whose keys and values are used for matching personalities in the database.  For example, a matching dictionary containing a 'IOProviderClass' key with the value 'IOPCIDevice' will cause termination for all instances whose personalities have the key 'IOProviderClass' equal to 'IOPCIDevice'.
192         @param matching  A dictionary whose keys and values are used for matching personalities in the database.  For example, a matching dictionary containing a 'IOProviderClass' key with the value 'IOPCIDevice' will start matching for all personalities which have the key 'IOProviderClass' equal to 'IOPCIDevice'.
200         Should only be used by kextd just before it sends all kext personalities down during a rescan.
206         @abstract Replace personalities in IOCatalog with those provided.