Skip Navigation Links | |
Exit Print View | |
![]() |
Oracle Solaris Cluster Data Services Developer's Guide Oracle Solaris Cluster 4.0 |
1. Overview of Resource Management
3. Resource Management API Reference
6. Data Service Development Library
8. Sample DSDL Resource Type Implementation
9. Oracle Solaris Cluster Agent Builder
Failover and Restart Functions
12. Cluster Reconfiguration Notification Protocol
A. Sample Data Service Code Listings
B. DSDL Sample Resource Type Code Listings
C. Requirements for Non-Cluster-Aware Applications
D. Document Type Definitions for the CRNP
The functions listed in this section retrieve, print, and free the network resources that are used by resources and resource groups. The scds_get_ functions in this section provide a convenient way of retrieving network resources without using the RMAPI functions to query specific properties, such as Network_resources_used and Port_list. The scds_print_name() functions print values from the data structures that are returned by the scds_get_name() functions. The scds_free_name() functions free the memory that is allocated by the scds_get_name() functions.
The following functions handle host names:
scds_get_rs_hostnames(3HA) – Retrieves a list of host names that is used by the resource.
scds_get_rg_hostnames(3HA) – Retrieves a list of host names that is used by the network resources in a resource group.
scds_print_net_list(3HA) – Writes the contents of the host name list to syslog(3C). You typically use this function for debugging.
scds_free_net_list(3HA) – Frees the memory that is allocated by scds_get_rs_hostnames() or scds_get_rg_hostnames().
The following functions handle port lists:
scds_get_port_list(3HA) – Retrieves a list of port-protocol pairs that is used by a resource.
scds_print_port_list(3HA) – Writes the contents of the port-protocol list to syslog(3C). You typically use this function for debugging.
scds_free_port_list(3HA) – Frees the memory that is allocated by scds_get_port_list().
The following functions handle network addresses:
scds_get_netaddr_list(3HA) – Retrieves a list of network addresses that is used by a resource.
scds_print_netaddr_list(3HA) – Writes the contents of the network address list to syslog(3C). You typically use this function for debugging.
scds_free_netaddr_list(3HA) – Frees the memory that is allocated by scds_get_netaddr_list().
The functions in this section enable TCP-based monitoring. Typically, a fault monitor uses these functions to establish a simple socket connection to a service, read and write data to the service to ascertain its status, and disconnect from the service.
These functions include the following:
scds_fm_tcp_connect(3HA) – Establishes a TCP connection to a process that uses IPv4 addressing only.
scds_fm_net_connect(3HA) – Establishes a TCP connection to a process that uses either IPv4 or IPv6 addressing.
scds_fm_tcp_read(3HA) – Uses a TCP connection to read data from the process that is being monitored.
scds_fm_tcp_write(3HA) – Uses a TCP connection to write data to a process that is being monitored.
scds_simple_probe(3HA) – Probes a process by establishing and terminating a TCP connection to the process. This function handles only IPv4 addresses.
scds_simple_net_probe(3HA) – Probes a process by establishing and terminating a TCP connection to the process. This function handles either IPv4 or IPv6 addresses.
scds_fm_tcp_disconnect(3HA) – Terminates the connection to a process that is being monitored. This function handles only IPv4 addresses.
scds_fm_net_disconnect(3HA) – Terminates the connection to a process that is being monitored. This function handles either IPv4 or IPv6 addresses.