GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SP_GET_VS_SETS_INFO (3)

NAME

SP_get_vs_sets_info, SP_scat_get_vs_sets_info - Extract list of VS sets from membership message

CONTENTS

Synopsis
Description
Bugs
Author

SYNOPSIS

#include <sp.h>

int SP_get_vs_sets_info( const char * memb_mess, vs_set_info *vs_sets, int num_vs_sets, unsigned int *my_vs_set_index);
int SP_scat_get_vs_sets_info( const scatter * memb_mess_scat, vs_set_info *vs_sets, int num_vs_sets, unsigned int *my_vs_set_index);

DESCRIPTION

SP_get_vs_sets_info and its scatter variant extract the list of VS sets provided in a Network membership message and store them into the vs_sets array of vs_set_info structs. The number of elements in the array should be provided in the num_vs_sets parameter.

This function also returns an index of which VS set in the array corresponds to the current process’s VS set. That index value is returned in the my_vs_set_index 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.

The fields of a vs_set_info struct include

unsigned int num_members
 
unsigned int member_offset
 

The member_offset field is the byte offset into the membership message body where this VS set’s member list begins. For each of the vs_set_info records in the array, the function SP_get_vs_set_members will grab the actual array of member names for the specified VS set.

RETURN VALUES

Returns a postivive value on success or one of the following errors ( < 0 ):
BUFFER_TOO_SHORT
  The allocated array of vs_set_info structs can not hold the number of VS sets contained in this membership message. No data is parsed. Reallocate a larger array of vs_set_info structs (the required number is available in the membership_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)

Search for    or go to Top of page |  Section 3 |  Main Index


SPREAD SP_GET_VS_SETS_INFO (3) February 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.