scds_pmf_signal(3ha) [opensolaris man page]

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

NAME

       scds_pmf_signal - send a signal to a process tree under PMF control

SYNOPSIS

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

       scha_err_t scds_pmf_signal(scds_handle_t handle, scds_pmf_type_t program_type,
	   int instance, int signal, time_t timeout

DESCRIPTION

       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 return-
       ing.  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.

PARAMETERS

       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.

RETURN VALUES

       The scds_pmf_signal() function returns the following:

       0		   The function succeeded.

       non-zero 	   The function failed.

ERRORS

       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.

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), scds_initialize(3HA), scha_calls(3HA), signal(3HEAD), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						      scds_pmf_signal(3HA)

Check Out this Related Man Page

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

NAME

       scds_simple_probe - probe by establishing and terminating a TCP connection to an application

SYNOPSIS

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

       scha_err_t scds_simple_probe(scds_handle_t handle, const char *hostname,
	   int port, time_t timeout

DESCRIPTION

       The scds_simple_probe() function is a wrapper function around connect(3SOCKET) and close(2) to run under a timeout.

       Retrieve the hostname with either scds_get_rg_hostnames(3HA) or scds_get_rs_hostnames(3HA).

       Consider using scds_simple_net_probe(3HA) instead of this function.

PARAMETERS

       The following parameters are supported:

       handle		   The handle returned by scds_initialize(3HA).

       hostname 	   Internet hostname of the machine to which to connect.

       port		   Port number with which to make the connection.

       timeout		   Timeout value in seconds (to wait for a successful connection).

RETURN VALUES

       The scds_simple_probe() function returns the following:

       0		   The function succeeded.

       nonzero		   The function failed.

ERRORS

       SCHA_ERR_NOERR		   Indicates that the function succeeded.

       SCHA_ERR_TIMEOUT 	   Indicates that the function timed out.

       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	     |Deprecated		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       close(2),  connect(3SOCKET), scds_fm_net_connect(3HA), scds_fm_net_disconnect(3HA), scds_get_rg_hostnames(3HA), scds_get_rs_hostnames(3HA),
       scds_initialize(3HA), scds_simple_net_probe(3HA), scha_calls(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						    scds_simple_probe(3HA)

Linux and UNIX Man Pages

scds_pmf_signal(3ha) [opensolaris man page]

Check Out this Related Man Page