scha_cluster_getzone(3ha) [opensolaris man page]

scha_cluster_getzone(3HA)				 Sun Cluster HA and Data Services				 scha_cluster_getzone(3HA)

NAME

       scha_cluster_getzone - zone 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_getzone(char **zonename);

DESCRIPTION

       The  scha_cluster_getzone() function returns a string that identifies the zone from which the function is called. If you call this function
       in a non-global zone, the zone name and the node name are returned, in the format nodename:zonename. If	you  call  this  function  in  the
       global  zone, only the node name is returned. The node name is not necessarily the same as the Solaris system name. The function returns an
       error status.  If successful, the function also returns a string that contains the node name and the zone name  in  the	location  that	is
       pointed to by the zonename argument.

       If the call fails, the zonename argument is set to NULL. The caller of scha_cluster_getzone() 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_getzone() function returns the following values:

       0		   The function succeeded.

       nonzero		   The function failed.

ERRORS

       SCHA_ERR_NOERR			   The function succeeded.

       See scha_calls(3HA) for a description of other error codes.

EXAMPLES

       Example 1 Using the scha_cluster_getzone() Function

	       scha_err_t  err_code;
	      char *zonename;
	      err_code = scha_cluster_getzone(&zonename);
	      ...
	      if (zonename != NULL) free(zonename);

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_getnodename(3HA), scha_strerror(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007						 scha_cluster_getzone(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)

Linux and UNIX Man Pages

scha_cluster_getzone(3ha) [opensolaris man page]

Check Out this Related Man Page