DragonFly On-Line Manual Pages

Search: Section:  

SP_GET_VS_SET_MEMBERS(3)         User Manuals         SP_GET_VS_SET_MEMBERS(3)


NAME

       SP_get_vs_set_members, SP_scat_get_vs_set_members - Extract list of
       members of a particular VS set from membership message


SYNOPSIS

       #include <sp.h>

       int SP_get_vs_set_members( const char * memb_mess, const vs_set_info
       *vs_set, char member_names[][MAX_GROUP_NAME], int member_names_count);
       int SP_scat_get_vs_set_members( const scatter * memb_mess_scat, const
       vs_set_info *vs_set, char member_names[][MAX_GROUP_NAME], int
       member_names_count);


DESCRIPTION

       SP_get_vs_set_members and its scatter variant extract the list of
       members of a particular VS set.  The members are stored into an array
       of strings, each of which is MAX_GROUP_NAME characters in length.  The
       number of strings (names) in the array should be provided in the
       member_names_count parameter.

       The memb_mess field or scatter field  should be the body of a message
       that was returned in a previous SP_receive call for a membership
       message.


RETURN VALUES

       Returns a postivive value on success or one of the following errors ( <
       0 ):

       BUFFER_TOO_SHORT
               The allocated array of member names can not hold the number of
               members in this VS set. No data is parsed. Reallocate a larger
               array of member names (the required number is available in the
               corresponding vs_set_info struct) and call this function again.


BUGS

       None.


AUTHOR

       Yair Amir <yairamir@cnds.jhu.edu>
       Jonathan Stanton <jonathan@cnds.jhu.edu>


SEE ALSO

       libspread(3)

SPREAD                           February 2006        SP_GET_VS_SET_MEMBERS(3)

Search: Section: