SSP_FLUSH

Section: User Manuals (3)
Updated: JULY 2001

NAME

SSP_flush - flush a group

SYNOPSIS

#include <ssp.h">ssp.h>
int SSP_flush( mailbox mbox, const char *group);

DESCRIPTION

SSP_flush flushes a group with the name passed as the string group. If the group does not exist amoung the Spread daemons, an error will be returned. By flushing a group, the application acknowledges the change of the group. No messages should be sent till the group is changed (a membership notification is received).

The mbox of the connection upon which to join a group is the first parameter.

The group string represents the name of the group to be flushed.

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 flush could not be initiated.
FLUSH_OK_ALREADY_SENT: The group was already flushed.

BUGS

None.

AUTHOR

Cristina Nita-Rotaru <crisn@cnds.jhu.edu>

This document was created by man2html, using the manual pages.
Time: 18:34:19 GMT, July 07, 2001

Questions or comments to:
webmaster (at) dsn.jhu.edu
TEL: (410) 516-5562
FAX: (410) 516-6134

Distributed Systems and Networks Lab
Computer Science Department
Johns Hopkins University
3400 N. Charles Street Baltimore, MD 21218-2686