DragonFly On-Line Manual Pages

Search: Section:  


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)

Search: Section: