Home | History | Annotate | Download | only in man3ha
 te
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License"). 
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
 Copyright 2007 Sun Microsystems, Inc. All rights
 reserved. Use is subject to license terms.
 scds_failover_rg 3HA "7 Sep 2007" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"
 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:


.na
handle
.ad


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




 RETURN VALUES

The following return values are supported:


.na
SCHA_ERR_NOERR
.ad


Indicates the function succeeded.





.na
Other values
.ad


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




 FILES

.na
/usr/cluster/include/rgm/libdsdev.h
.ad


Include file





.na
/usr/cluster/lib/libdsdev.so
.ad


Library




 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving



 SEE ALSO

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