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

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:

       handle		   The handle returned from scds_initialize()

       instance 	   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:

       0		   The function succeeded.

       non-zero 	   The function failed.

ERRORS

       SCHA_ERR_NOERR	   Function succeeded

       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

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

Sun Cluster 3.2 						    7 Sep 2007						  scds_pmf_restart_fm(3HA)