Network Resource Access Functions

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, Resource_dependencies, 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.

Host 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().

Port List Functions

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().

Network Address Functions

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().

Fault Monitoring Using TCP Connections Functions

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.