scds_fm_tcp_connect (3HA)

名称

scds_fm_tcp_connect - 建立与应用程序的 TCP 连接

用法概要

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

描述

scds_fm_tcp_connect() 函数可与受监视进程建立 TCP 连接。

使用 scds_get_rs_hostnames(3HA) 或 scds_get_rg_hostnames(3HA ) 检索主机名。

考虑使用 scds_fm_net_connect(3HA) 代替此函数。

参数

支持以下参数：

handle

由 scds_initialize(3HA) 返回的句柄。

sock

指向此函数建立的套接字的句柄。此参数是由此函数设置的输出参数。

hostname

进程侦听的主机的名称。如果 hostname 仅映射到 IPv4 地址，或者同时映射到 IPv4 和 IPv6 地址，此函数将使用 IPv4 映射作为连接地址。如果 hostname 仅映射到 IPv6 地址，此函数将使用该 IPv6 映射作为连接地址。

port

TCP 端口号。

timeout

超时值（秒）。

返回值

scds_fm_tcp_connect() 函数返回以下值：

0

该函数成功。

非零值

该函数失败。

错误

SCHA_ERR_NOERR

表明函数执行成功。

SCHA_ERR_STATE

表明尝试在套接字上发起连接时由于超时以外的原因失败。

SCHA_ERR_TIMEOUT

表明函数超时。

其他值

表明函数执行失败。有关失败代码的含义，请参见 scha_calls(3HA)。

文件

/usr/cluster/include/rgm/libdsdev.h

头文件

/usr/cluster/lib/libdsdev.so

库

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 ha-cluster/developer/api 接口稳定性 Deprecated（已过时）

另请参见

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)