test

Sun Cluster 数据服务开发者指南（适用于 Solaris OS）

第 11 章 数据服务开发库参考

本章列举并简单介绍了数据服务开发库 (DSDL) API 函数。有关每一个 DSDL 函数的完整介绍，请参见各个 3HA 手册页。DSDL 仅定义了一个 C 接口。基于脚本的 DSDL 接口不可用。

DSDL 提供以下函数类型：

DSDL 函数

以下各小节简要介绍了各类 DSDL 函数。但是，各个 3HA 手册页才是 DSDL 函数的权威参考。

通用函数

本节中介绍的函数具有很多功能。使用这些函数您可以执行以下操作：

以下函数用来初始化调用方法：

以下函数用来检索有关资源、资源类型、资源组和扩展特性的信息：

以下函数用来检索某资源所使用的所有 SUNW.HAStoragePlus 资源的状态信息：

以下函数用来进行故障转移或重新启动资源或资源组：

以下函数在超时值定义的时间内执行命令，并将错误代码转换成错误消息：

特性函数

这些函数提供了公用 API，可用来存取相关资源、资源组和资源类型的具体特性，其中包括一些常用的扩展特性。DSDL 提供了 scds_initialize 函数，可用来分析命令行参数。然后该库将缓存相关资源、资源组和资源类型的各种特性。

scds_property_functions(3HA) 中介绍了这些函数。这些函数包括：

网络资源存取函数

本节中列出的函数用来检索、打印和释放资源和资源组所使用的网络资源。本节中的 scds_get_* 函数提供了一种可用来检索网络资源而又无需使用 RMAPI 函数查询具体特性（例如 Network_resources_used 和 Port_list）的简便方式。scds_print_name() 函数用来打印 scds_get_ name() 函数返回的数据结构的值。scds_free_ name() 函数用来释放通过 scds_get_name() 函数分配的内存。

处理主机名的函数包括：

用于处理端口列表的函数包括：

用于处理网络地址的函数包括：

使用 TCP 连接进行故障监视

本节介绍的函数用来启用基于 TCP 的监视功能。通常，故障监视器使用这些函数建立服务的简单套接字连接，对该服务进行读写操作以确定其状态，然后从该服务断开连接。

这些函数包括：

PMF 函数

这些函数封装了 PMF 的功能。通过 PMF 进行监视的 DSDL 模型可以创建并使用 pmfadm(1M) 的隐含 tag 值。PMF 工具还使用 Restart_interval、Retry_count 和 action_script（pmfadm 的 -t、-n 和 -a 选项）的隐含值。最重要的是，DSDL 将把 PMF 发现进程停止情况时进行的进程停止历史记录与故障监视器检测到故障情况时进行的应用程序故障历史记录结合起来，以通过计算决定是进行重启还是进行故障转移。

这些函数包括：

故障监视器函数

本节中介绍的函数通过保留失败历史记录，并与 Retry_count 和 Retry_interval 特性一起对其进行计算，提供了一种预设的故障监视模型。

这些函数包括：

实用程序函数

使用本节介绍的函数可以向系统日志写入消息和调试消息。这些函数包括：