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