NAME
    SCI_Group_free - Free an existed group

C Syntax
    #include <sci.h>
    int SCI_Group_free(sci_group_t group)

INPUT PARAMETERS
    group
        The group to be freed (IN).

DESCRIPTION
    This subroutine is used to free an existed group which was previously created by
    SCI_Group_create, SCI_Group_operate or SCI_Group_operate_ext.

    This is a blocking call. The caller can assume group can't be used again upon the
    return of the function.

    For more information, please refer to SCI's online documents.

EXAMPLE
        {
                    sci_group_t odd_group, even_group;
                    ...
                    SCI_Group_free(odd_group);
                    SCI_Group_free(even_group);
        }

ERRORS
    All SCI routines return an error value.

    SCI_ERR_UNINTIALIZED
        Uninitialized SCI execution environment
    SCI_ERR_INVALID_CALLER
        Can only be called in the front end
    SCI_ERR_GROUP_PREDEFINED
        Can't free predefined group SCI_GROUP_ALL
    SCI_ERR_GROUP_NOTFOUND
        The group to be freed does not exist
    SCI_ERR_NO_MEM
        Out of memory

SEE ALSO
    SCI_Group_create(3)
    SCI_Group_operate(3)
    SCI_Group_operate_ext(3)