Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Data Services Developer's Guide Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |