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: