cl_alloc_groupmap routine

The cl_alloc_groupmap routine allocates storage for a list of resource group descriptors. This routine must be called before calling the cl_getgroups routine.

After calling the cl_getgroups routine, free the storage when you are done by calling the cl_free_groupmap routine.

Syntax

int cl_alloc_groupmap (struct cl_group **groupmap);

Parameters

Item Description
groupmap The base pointer for the group map.

Status codes

Item Description
CLE_OK The request completed successfully.
CLE_BADARGS Missing or invalid parameters. This status usually indicates that a NULL pointer was specified for the groupmap argument.

Example

See the example for the cl_getgroupmap routine.