SSP_CONNECTSection: User Manuals (3)
Updated: JULY 2001
NAMESSP_connect - Connect an application to a daemon
int SSP_connect( const char *spread_name, const char *private_name, int priority, int group_membership, mailbox *mbox, char *private_group);
DESCRIPTIONSSP_connect is the initial call an application must make to establish a connection with a Spread daemon. All other spread calls must refer to a valid mbox returned by this function.
The spread_name is the name of the Spread daemon to connect to. It should be a string in one of the following forms:
The private_name is the name this connection would like to be known as. It must be unique on the machine running the spread daemon. The name can be of at most MAX_PRIVATE_NAME characters, with the same character restrictions as a group name (mainly it cannot contain the '#' character).
The priority is a 0/1 flag for whether this connection will be a "Priority" connection or not. Currently this has no effect.
The group_membership is a boolean integer. If 1 then the application will receive group membership messages for this connection, if 0 then the application will not receive any membership change messages. For Secure Spread is not used, the application must and will receive membership notifications. It is used just for compatibility with SP_connect.
The mbox should be a pointer to a mailbox variable. After the SSP_connect call returns this variable will hold the mbox for the connection.
The private_group should be a pointer to a string big enough to hold at least MAX_GROUP_NAME characters. After the Connect call returns it will contain the private group name of this connection. This group name can be used to send unicast messages to this connection and no one can join this special group.
RETURN VALUESReturns ACCEPT_SESSION on success or one of the following errors ( < 0 ):
AUTHORCristina Nita-Rotaru <firstname.lastname@example.org>
This document was created by man2html, using the manual pages.
Time: 20:33:48 GMT, July 06, 2001