SP_get_memb_info and its scatter
variant all parse the contents of a message body that is received
as part of a membership message and fill in the membership_info
struct that is passed in as a parameter.
The service_type and the memb_mess fields
should be the same as the values returned in a previous SP_receive
call for a membership message. The caller should allocate
a new membership_info structure and pass that into this function.
When the function returns the structure will be filled in.
The fields of a membership_info struct include:
- group_id gid
- char changed_member[MAX_GROUP_NAME]
- unsigned int num_vs_set
- vs_set_info my_vs_set
The changed_member field is filled in with the name of the
new or leaving member if the membership is a Join, Leave or
Disconnect. If it is a Network membership event then the changed_member
field is blank and multiple vs_sets will be available with
all of the subsets of daemons coming together into the new
membership.
The my_vs_set field stores the number of members
of my local vs set, i.e. those processes who came together
with me and the location of the list of members. See SP_get_vs_set_members
for how to extract the full list of members. The SP_get_vs_sets_info
function will return the full list of all VS sets that arrived
with this membership message.
|