iokit/IOKit/IORegistryEntry.h

627     /* Name, location and path accessors */
683     @abstract Returns the location string assigned to the registry entry as a C-string.
684     @discussion Entries can given a location string in a particular plane, or globally. If the entry has had a location set in a plane and the plane is specified that location string will be returned, otherwise the global location string is returned. If no global location string has been set, zero is returned.
686     @result A C-string location string, valid while the entry is retained, or zero. */
691     @abstract Returns the location string assigned to the registry entry as an OSSymbol.
692     @discussion Entries can given a location string in a particular plane, or globally. If the entry has had a location set in a plane and the plane is specified that location string will be returned, otherwise the global location string is returned. If no global location string has been set, zero is returned.
694     @result A reference to an OSSymbol for the location if one exists, which should be released by the caller, or zero. */
700     @abstract Sets a location string for the registry entry, in a particular plane, or globally.
701     @discussion Entries can be given a location string in a particular plane, or globally. If the plane is specified the location applies only to that plane, otherwise the global location is set. The location string may be used during path lookups of registry entries, to distinguish between sibling entries with the same name. The default IORegistryEntry parsing of location strings expects a list of hex numbers separated by commas, though subclasses of IORegistryEntry might do their own parsing.
702     @param location A C-string location string which will be copied, or an OSSymbol which will be retained.
703     @param plane The plane object, or zero to set the global location string. */
705     virtual void setLocation( const OSSymbol * location,
707     virtual void setLocation( const char * location,
723     @discussion Each component of a path created with getPath is created with getPathComponent. The default implementation concatenates the entry's name in the the plane, with the "at" symbol and the location string of the entry in the plane if it has been set.