lsb_usergrpinfo

Returns LSF user group membership.

lsb_usergrpinfo gets LSF user group membership. LSF user group is defined in the configuration file lsb.users. The storage for the array of groupInfoEnt structures will be reused by the next call.

#include <lsf/lsbatch.h>

struct groupInfoEnt *lsb_usergrpinfo (char **groups, int *numGroups, int options)

Parameters:

	**groups	An array of group names.
	*numGroups	The number of group names. *numGroups will be updated to the actual number of groups when this call returns.
	options	The bitwise inclusive OR of some of flags in group_membership_option

Data Structures:

groupInfoEnt

Define Statements:

group_membership_option
group_define

Returns:

struct groupInfoEnt *:
On success, returns an array of groupInfoEnt structures which hold the group name and the list of names of its members. If a member of a group is itself a group(i.e., a subgroup), then a '/' is appended to the name to indicate this. *numGroups is the number of groupInfoEnt structures returned.

NULL
Function failed.

Errors:

On failure, returns NULL and sets lsberrno to indicate the error. If there are invalid groups specified, the function returns the groups up to the invalid ones. It then set lsberrno to LSBE_BAD_GROUP, that is the specified (*groups)[*numGroups] is not a group known to the LSF system. If the first group is invalid, the function returns NULL.

Equivalent line commands:

none

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.hosts
$LSB_CONFDIR/cluster_name/configdir/lsb.users

See also:

lsb_hostgrpinfo