The method_delgroup Interface

int method_delgroup (void *handlep, char *group);

The handlep parameter is a handle to the load module opened with the method_open interface. The group parameter points to the requested group.

method_delgroup removes a group account and all associated information. A call to method_commit is not required. The group will be removed immediately.

method_delgroup is called when putgroupattr is invoked with a Type parameter of SEC_DELETE. The value of the Group and Attribute parameters will be passed directly to method_delgroup.

method_delgroup returns 0 when the group has been successfully removed. On failure a value of -1 is returned and the global variable errno is set to indicate the cause. A value of ENOSYS is used when deleting groups is not supported by the module. A value of EPERM is used when the invoker does not have permission to delete the group. A value of ENOENT is used when the group does not exist. A value of EROFS is used when the module was not opened for updates. A value of EBUSY is used when the group has defined members.