The method_getgrnam Interface

struct group *method_getgrnam (void *handlep, const 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_getgrnam retrieves group account information given the group name. The group account information consists of the group name, identifier, and complete member list.

method_getgrnam is called as a result of calling the getgrnam subroutine. This interface may also be called if method_getentry is not defined.

method_getgrnam returns a pointer to the group's group file structure on success. On failure a NULL pointer is returned.