ns_group

Overview

Add, delete, update, or get information about AOLserver groups

Syntax

ns_group add ?-server servername? group description users

ns_group delete ?-server servername? group

ns_group description ?-server servername? group

ns_group exists ?-server servername? group

ns_group list ?-server servername?

ns_group update ?-server servername? group description users

ns_group users ?-server servername? group

Description

ns_group add adds the specified group and gives it the specified description the specified list of users. If no servername is specified, the current virtual server is used.

ns_group delete deletes the specified group. If no servername is specified, the current virtual server is used.

ns_group description returns the description for the specified group. If no servername is specified, the current virtual server is used.

ns_group exists returns 1 (one) if the specified group exists and 0 (zero) if it does not. If no servername is specified, the current virtual server is used.

ns_group list returns a list of group names. If no servername is specified, the current virtual server is used.

ns_group update updates the specified group. The description of the group and the list of users will be updated with the information in the description and users arguments, respectively. Note that all arguments must be specified, even if you are only updating one of them. If no servername is specified, the current virtual server is used.

ns_group users returns a list of users belonging to the specified group. If no servername is specified, the current virtual server is used.

Note

This function normally updates the groups disk file each time it is called. To perform large-scale loading of groups, first call ns_perm syncoff to disable the file synchronization mechanism, then perform multiple calls to ns_group, and finally call ns_perm syncon to re-enable the file synchronization.