opensolaris man page for scds_failover_rg

scds_failover_rg(3HA)					 Sun Cluster HA and Data Services				     scds_failover_rg(3HA)

NAME
       scds_failover_rg - failover a resource group

SYNOPSIS
       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  dsdev
       #include <rgm/libdsdev.h>

       scha_err_t scds_failover_rg(scds_handle_t handle);

DESCRIPTION
       The  scds_failover_rg()	function performs a scha_control(3HA) SCHA_GIVEOVER operation on the resource group containing the resource passed
       to the calling program.

       When this function succeeds, it does not return. Therefore, treat this function as the last piece of code to be	executed  in  the  calling
       program.

PARAMETERS
       The following parameters are supported:

       handle		   The handle that is returned from scds_initialize(3HA).

RETURN VALUES
       The following return values are supported:

       SCHA_ERR_NOERR	   Indicates the function succeeded.

       Other values	   Indicate the function failed. See scha_calls(3HA) for a description of other error codes.

FILES
       /usr/cluster/include/rgm/libdsdev.h

	   Include file

       /usr/cluster/lib/libdsdev.so

	   Library

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscdev 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       scha_calls(3HA), scha_control(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						     scds_failover_rg(3HA)