Sun Microsystems, Inc.
   www.sun.com docs.sun.com | | |  
   
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_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).


PARAMETERS

 

The following parameters are supported:

handle
The handle returned from scds_initialize(3HA)
hostname
Internet hostname of the machine to connect to
port
Port number to make the connection with
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.
non-zero
The function failed.

ERRORS

 
SCHA_ERR_NOERR
Indicates the function succeeded.
SCHA_ERR_TIMEOUT
Indicates 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving

SEE ALSO

 

close(2), connect(3socket), scds_get_rg_hostnames(3HA), scds_get_rs_hostnames(3HA), scds_initialize(3HA), scha_calls(3HA), attributes(5)



Sun Cluster 3.1Go To TopLast Changed 24 July2002

 
      
      
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.