Spread 3.17.3 C API

SP_join
 
int SP_join (mailbox mbox, const char *group);


Parameters
  mbox connection handle to perform group join on
  group represents the name of the group to join.


Return Values
  0 Success
  ILLEGAL_GROUP The group given to join was illegal for some reason. Usually because it was of length 0 or length > MAX_GROUP_NAME
  ILLEGAL_SESSION The session specified by mbox is illegal. Usually because it is not active.
  CONNECTION_CLOSED During communication errors occurred and the join could not be initiated.


Description
  SP_join joins a group with the name passed as the string group. If the group does not exist among the Spread daemons it is created, otherwise the Join joins the existing group.


Requirements
  Header: Include sp.h
Library: Use libspread or libtspread
Version: 3.17.3


Also See
  SP_leave