scha_cluster_getnodename(3ha) [opensolaris man page]
scha_cluster_getnodename(3HA) Sun Cluster HA and Data Services scha_cluster_getnodename(3HA) NAME
scha_cluster_getnodename - local cluster node name access function SYNOPSIS
cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib -l scha #include <scha.h> scha_err_t scha_cluster_getnodename(char **nodename); DESCRIPTION
The scha_cluster_getnodename() function returns the name of the cluster node on which the function is called. The node name is not neces- sarily the same as the Solaris system name. The function returns an error status, and if successful, a string that contains the node name in the location that is pointed to by the nodename argument. If the call fails, the nodename is set to NULL. The caller of scha_cluster_getnodename() is responsible for freeing the memory that is allocated for the returned string by using the standard C library function free(3C). Freeing the memory is required only if the function succeeds. RETURN VALUES
The scha_cluster_getnodename() function returns the following values: 0 The function succeeded. nonzero The function failed. ERRORS
SCHA_ERR_NOERR Function succeeded. See scha_calls(3HA) for a description of other error codes. EXAMPLES
Example 1 Using the scha_cluster_getnodename() Function scha_err_t err_code; char *nodename; err_code = scha_cluster_getnodename(&nodename); ... if (nodename != NULL) free(nodename); FILES
/usr/cluster/include/scha.h Include file /usr/cluster/lib/libscha.so Library ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWscdev | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
free(3C), scha_calls(3HA), scha_cluster_get(3HA), scha_cluster_getzone(3HA), scha_strerror(3HA), attributes(5) Sun Cluster 3.2 7 Sep 2007 scha_cluster_getnodename(3HA)
Check Out this Related Man Page
scds_simple_probe(3HA) Sun Cluster HA and Data Services scds_simple_probe(3HA) NAME
scds_simple_probe - probe by establishing and terminating a TCP connection to an application SYNOPSIS
cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib -l dsdev #include <rgm/libdsdev.h> scha_err_t scds_simple_probe(scds_handle_t handle, const char *hostname, int port, time_t timeout DESCRIPTION
The scds_simple_probe() function is a wrapper function around connect(3SOCKET) and close(2) to run under a timeout. Retrieve the hostname with either scds_get_rg_hostnames(3HA) or scds_get_rs_hostnames(3HA). Consider using scds_simple_net_probe(3HA) instead of this function. PARAMETERS
The following parameters are supported: handle The handle returned by scds_initialize(3HA). hostname Internet hostname of the machine to which to connect. port Port number with which to make the connection. timeout Timeout value in seconds (to wait for a successful connection). RETURN VALUES
The scds_simple_probe() function returns the following: 0 The function succeeded. nonzero The function failed. ERRORS
SCHA_ERR_NOERR Indicates that the function succeeded. SCHA_ERR_TIMEOUT Indicates that the function timed out. See scha_calls(3HA) for a description of other error codes. FILES
/usr/cluster/include/rgm/libdsdev.h Include file /usr/cluster/lib/libdsdev.so Library ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWscdev | +-----------------------------+-----------------------------+ |Interface Stability |Deprecated | +-----------------------------+-----------------------------+ SEE ALSO
close(2), connect(3SOCKET), scds_fm_net_connect(3HA), scds_fm_net_disconnect(3HA), scds_get_rg_hostnames(3HA), scds_get_rs_hostnames(3HA), scds_initialize(3HA), scds_simple_net_probe(3HA), scha_calls(3HA), attributes(5) Sun Cluster 3.2 7 Sep 2007 scds_simple_probe(3HA)