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 2008 Sun Microsystems, Inc. All
 rights reserved. Use is subject to license terms.
 scds_pmf_restart_fm 3HA "13 Aug 2008" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"
 NAME
scds_pmf_restart_fm - restart fault monitor using
PMF

 SYNOPSIS


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

scha_err_t scds_pmf_restart_fm(scds_handle_t handle, int instance);




 DESCRIPTION

The scds_pmf_restart_fm() function sends a SIGKILL signal to the fault monitor process tree to kill the fault monitor
and then uses PMF to restart it. This function uses the MONITOR_STOP_TIMEOUT property as its timeout value. That is, scds_pmf_restart_fm() waits
at most the value of the MONITOR_STOP_TIMEOUT property
for the process tree to die.


If the MONITOR_STOP_TIMEOUT property is not explicitly
set in the RTR file, the default timeout value is used.


One way to use this function is to call it in an UPDATE method
to restart the monitor, possibly with new parameters.

 PARAMETERS

The following parameters are supported:


.na
handle
.ad


The handle returned from scds_initialize()





.na
instance
.ad


For resources with multiple instances of the fault monitor,
this integer, starting at 0, uniquely identifies the fault monitor instance.
For single instance fault monitors, use 0. 




 RETURN VALUES

The scds_pmf_restart_fm() function returns the following:


.na
0
.ad


The function succeeded.





.na
non-zero
.ad


The function failed.




 ERRORS

.na
SCHA_ERR_NOERR 
.ad


Function succeeded





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

pmfadm(1M), scha_calls(3HA), signal(3HEAD), attributes(5) , r_properties(5)