Purpose
ha_gs_quit - Called by a GS client to terminate its connection to the Group Services subsystem
Library
GSAPI Thread-Safe Library (libha_gs_r.a)
GSAPI Library (not thread-safe) (libha_gs.a)
Syntax
#include <ha_gs.h>
void
ha_gs_quit(void)
Parameters
None.
Description
When a GS client no longer needs to use the Group Services subsystem, it should call the ha_gs_quit subroutine to terminate its connection to the Group Services subsystem. This allows Group Services to release the resources associated with the GS client.
If the GS client is still joined as a provider to any groups, the Group Services subsystem will notify the groups that the provider has failed, and the groups will invoke a failure leave protocol. If the GS client wants to leave a group without terminating its connection, it should use the ha_gs_leave subroutine or the ha_gs_goodbye subroutine.
See the discussion of multi-threaded GS clients under .
Restrictions
The calling process must be a GS client.
Return Values
None.
Error Values
None.
Synchronous Errors
None.
Asynchronous Errors
None.
Files
ha_gs.h
Prerequisite Information
Related Information
Subroutines: ha_gs_init, ha_gs_join, ha_gs_dispatch