Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018
 
 

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/developer/api
Interface Stability
Evolving

See Also

scha_calls(3HA), signal(3HEAD), attributes(7), r_properties(7) , pmfadm(8)