DragonFly On-Line Manual Pages
SP_JOIN(3) User Manuals SP_JOIN(3)
NAME
SP_join - create connection between app and daemon
SYNOPSIS
#include <sp.h>
int SP_join( mailbox mbox, const char *group);
DESCRIPTION
SP_join joins a group with the name passed as the string group. If the
group does not exist amoung the Spread daemons it is created, otherwise
the Join joins the existing group. The mbox of the connection upon
which to join a group is the first parameter.</P> The group
string represents the name of the group to join.
RETURN VALUES
Returns 0 on success or one of the following errors ( < 0 ):
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 occured and the join could not be
initiated.
BUGS
None.
AUTHOR
Yair Amir <yairamir@cnds.jhu.edu>
Jonathan Stanton <jonathan@cnds.jhu.edu>
SEE ALSO
libspread(3)
SPREAD JULY 1998 SP_JOIN(3)