The scds_pmf_signal() function sends the specified signal to a process tree running under PMF control. This function is equivalent to the pmfadm(1M) command with the -k option.

After sending the signal, the scds_pmf_signal() function waits for the specified timeout period for the process tree to die, before returning. A value of 0 for timeout tells the function to return immediately without waiting for any process to exit. A value of -1 tells the function to wait indefintely for the processes to exit.

The following parameters are supported:

handle

The handle returned from scds_initialize()

program_type

Type of program to execute. Valid types are:

SCDS_PMF_TYPE_SVC

Data service application

SCDS_PMF_TYPE_MON

Fault monitor

SCDS_PMF_TYPE_OTHER

Other

instance

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

signal

Solaris signal to send. See signal(3head).

timeout

Timeout period in seconds.

The scds_pmf_signal() function returns the following:

0

The function succeeded.

non-zero

The function failed.

SCHA_ERR_TIMEOUT

The process tree did not exit within the specified timeout period after the signal was sent.

SCHA_ERR_NOERR

The function succeeded.

Other values

Indicate the function failed. See scha_calls(3HA) for the meaning of failure codes.

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

Include file

/usr/cluster/lib/libdsdev.so

Library

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

pmfadm(1M), scds_initialize(3HA), scha_calls(3HA), signal(3head), attributes(5)