lsb_hostgrpinfo

Returns LSF host group membership.

lsb_hostgrpinfo gets LSF host group membership.

LSF host group is defined in the configuration file lsb.hosts.

The storage for the array of groupInfoEnt structures will be reused by the next call.

#include <lsf/lsbatch.h>

struct groupInfoEnt *lsb_hostgrpinfo (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 the following flags: GRP_RECURSIVE Expand the group membership recursively. That is, if a member of a group is itself a group, give the names of its members recursively, rather than its name, which is the default. GRP_ALL Get membership of all groups.

Data Structures:

groupInfoEnt
userShares

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 and then sets lsberrno to LSBE_BAD_GROUP, which means that the specified (*groups)[*numGroups] is not a group known to the LSF system. If the first group specified 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_usergrpinfo