Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Sun Cluster HA and Data Servicesscds_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).


PARAMETERS

 

The following parameters are supported:

handle
The handle returned from scds_initialize(3HA).
sock
A handle to the socket established by this function. This is an output argument set by this function.
hostname
Name of the host where the process is listening.
port
TCP port number.
timeout
Timeout value in seconds.


RETURN VALUES

 

The scds_fm_tcp_connect() function returns the following:

0
The function succeeded.
non-zero
The function failed.

ERRORS

 
SCHA_ERR_NOERR
Indicates 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 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving

SEE ALSO

 

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



Sun Cluster 3.1Go To TopLast Changed 05 May 2003