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 mem‐
ber_names_count);
DESCRIPTION
SP_get_vs_set_members and its scatter variant extract the list of mem‐
bers 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 mem‐
ber_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 mes‐
sage.
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 ALSOlibspread(3)SPREAD February 2006 SP_GET_VS_SET_MEMBERS(3)
