scds_fm_tcp_connect(3ha) [opensolaris man page]

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

NAME

       scds_fm_tcp_connect - establish 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_fm_tcp_connect(scds_handle_t handle, int *sock, const char*hostname,
	   int port, time_t timeout

DESCRIPTION

       The scds_fm_tcp_connect() function establishes a TCP connection with a process being monitored.

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

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

PARAMETERS

       The following parameters are supported:

       handle		   The handle returned by scds_initialize(3HA).

       sock		   A handle to the socket established by this function. This parameter is an output argument set by this function.

       hostname 	   Name of the host where the process is listening. If the hostname maps to an IPv4 address only, or to both IPv4 and IPv6
			   addresses, this function uses the IPv4 mapping as the address at which to connect. If the  hostname	maps  to  an  IPv6
			   address only, this function uses that IPv6 mapping as the address at which to connect.

       port		   TCP port number.

       timeout		   Timeout value in seconds.

RETURN VALUES

       The scds_fm_tcp_connect() function returns the following:

       0		   The function succeeded.

       nonzero		   The function failed.

ERRORS

       SCHA_ERR_NOERR		   Indicates that the function succeeded.

       SCHA_ERR_STATE		   Indicates that an attempt to initiate a connection on a socket failed for reasons other than a timeout.

       SCHA_ERR_TIMEOUT 	   Indicates that the function timed out.

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

SEE ALSO

       scds_fm_net_connect(3HA),   scds_fm_tcp_disconnect(3HA),   scds_get_rg_hostnames(3HA),	scds_get_rs_hostnames(3HA),  scds_initialize(3HA),
       scha_calls(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						  scds_fm_tcp_connect(3HA)

Check Out this Related Man Page

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

NAME

       scds_get_netaddr_list - get the network addresses used by a resource

SYNOPSIS

       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  dsdev
       #include <rgm/libdsdev.h>
       scha_err_t scds_get_netaddr_list(scds_handle_t handle,
	   scds_netaddr_list_t **netaddr_list

DESCRIPTION

       The  scds_get_netaddr_list() function returns all hostname, port, and protocol combinations that are in use by the resource. These combina-
       tions are derived by combining the Port_list property settings on the resource with all the hostnames in use by the resource,  as  returned
       by the scds_get_rs_hostnames() function.

       Use  scds_get_netaddr_list() in a fault monitor to monitor the resource, and to derive the list of hostnames, ports, and protocols that are
       in use by the resource .

       Values for the protocol type are defined in header file <rgm/libdsdev.h>.

       Free the memory that is allocated and returned by this function with scds_free_netaddr_list().

PARAMETERS

       The following parameters are supported:

       handle		   The handle that is returned by scds_initialize()

       netaddr_list	   The list of hostnames, ports, and protocols that are used by the resource group

RETURN VALUES

       The scds_get_netaddr_list() function returns the following values:

       0		   The function succeeded.

       nonzero		   The function failed.

ERRORS

       SCHA_ERR_NOERR	   Indicates that the function succeeded

       Other values	   Indicate that 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

       scds_free_netaddr_list(3HA), scds_get_rs_hostnames(3HA), scha_calls(3HA), r_properties(5), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						scds_get_netaddr_list(3HA)

Linux and UNIX Man Pages

scds_fm_tcp_connect(3ha) [opensolaris man page]

Check Out this Related Man Page