getgroupsbyname


>>-getgroupsbyname--name--stem---------------------------------><

Function

getgroupsbyname invokes the getgroupsbyname callable service to get the number of supplementary group IDs (GIDs) for a specified user name and, optionally, get a list of those supplementary group IDs.

Parameters

name: A string that specifies the name of the user as defined to the system.
stem: The name of a stem variable used to return the information. Upon return, stem.0 contains the number of variables returned. stem.1 to stem.n (where n is the number of variables returned) each contain a supplementary group ID for name.

Usage notes

A RETVAL greater than zero indicates success. A RETVAL of -1 or 0 indicates failure. A RETVAL of 0 has an ERRNOJR, but no ERRNO.

Example

To get the number of supplementary group IDs for the user MEGA:

"getgroupsbyname MEGA supgrp."