Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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)

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |