Functions

getInstance

Returns the singleton GlowWorm instance.

initLocalGroupList

Retrieves the local group list from NetInfo.

initLocalUserList

Retrieves the local user list from NetInfo.

localUsers

Returns the local user list for this machine.

Returns the singleton GlowWorm instance.

+ (
        GlowWorm *)getInstance; 

function result

Return: GlowWorm - The single static instance of GlowWorm for this runtime. NULL - Something went horribly wrong.

Discussion

Only a single instance of GlowWorm should exist at a time. The creation of this single instance is handled internally. Just call this class method to get it.

Retrieves the local group list from NetInfo.

- (
        BOOL)initLocalGroupList; 

function result

Return: TRUE - Was able to retrieve the local group list. FALSE - Was not able to retrieve the local group list.

Discussion

If you are writing a plugin, you do not ever need to call this method. If you are writing a stand-alone application, this method needs to be called before the localGroups method will be able to return the local group list.

Ultimately, this mess will be handled through the kernel extension, so that the local group list will pertain to the machine running the kernel extension and not necessarily the machine running the application.

Retrieves the local user list from NetInfo.

- (
        BOOL)initLocalUserList; 

function result

Return: TRUE - Was able to retrieve the local user list. FALSE - Was not able to retrieve the local user list.

Discussion

If you are writing a plugin, you do not ever need to call this method. If you are writing a stand-alone application, this method needs to be called before the localUsers method will be able to return the local user list.

Ultimately, this mess will be handled through the kernel extension, so that the local user list will pertain to the machine running the kernel extension and not necessarily the machine running the application.

Returns the local user list for this machine.

- (
        NSDictionary *)localUsers; 

function result

Return: NSDictionary - The local user list. NULL - The initLocalUserList method was not called first or did not succeed.

Discussion

Before this will return the local user list, the initLocalUserList method must be called. If you are writing a plugin, you do not need to worry about this. If you are writing a stand-alone application then you must make sure this is accomplished.

The elements of the NSDictionary returned by this method are keyed on the respective uids (NSNumber) of the users. Each object is also an NSDictionary with the keys "name", "realname" and "uid".

(Last Updated January 25, 2007)