Go to main content

Oracle Solaris Cluster 4.3 Reference Manual

Exit Print View

Updated: September 2015
 
 

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
ha-cluster/developer/api
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)