scha_cluster_getlogfacility(3ha) [opensolaris man page]

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

NAME

       scha_cluster_getlogfacility - cluster log facility access

SYNOPSIS

       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  scha
       #include <scha.h>

	scha_err_t scha_cluster_getlogfacility(int *logfacility);

DESCRIPTION

       The  scha_cluster_getlogfacility()  function  returns  the  system  log facility number that is being used as the cluster log. The value is
       intended to be used with the Solaris syslog(3C) function by resource type implementations to record events and status messages to the clus-
       ter log.

       The function returns an error status, and if successful, the facility number in the location pointed to by the logfacility argument.

RETURN VALUES

       The scha_cluster_getlogfacility() function returns the following:

       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_getlogfacility() Function

	 main()
	 {
	      scha_err_t     err_code;
	      int logfacility;

	      err_code = scha_cluster_getlogfacility(&logfacility);

	      if (err_code == SCHA_ERR_NOERR) {
		   openlog("test resource", LOG_CONS, logfacility);
		   syslog(LOG_INFO, "Access function call succeeded.");
	      }
	 }

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

       syslog(3C), scha_calls(3HA), scha_cluster_get(3HA), scha_strerror(3HA), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007					  scha_cluster_getlogfacility(3HA)

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

NAME

       scha_strerror, scha_strerror_i18n - generate error message from error code

SYNOPSIS

       cc [flags...] -I /usr/cluster/include file -L /usr/cluster/lib  -l  scha
       #include <scha.h>

       char *scha_strerror(scha_err_t error_code);

       char *scha_strerror_i18n(scha_err_t error_code);

DESCRIPTION

       The  scha_strerror()  and  scha_strerror_i18n()	functions generate a short string that describes the error from the given scha_err_t error
       code. Strings that are returned by scha_strerror() are displayed in English. Strings that are returned  by  scha_strerror_i18n()  are  dis-
       played in the native language that is specified by the LC_MESSAGES locale category. See setlocale(3C).

PARAMETERS

       The following parameters are supported:

       error_code	   Error code from which the short string that describes the error is generated.

EXAMPLES

       Example 1 Using the scha_strerror_i18n() Function

	 sample()
	 {
	      scha_err_t  err;

	      /* resource group containing example_R */
	      char * resource_group = "example_RG";

	      /* a configured resource */
	      char * resource_name = "example_R";

	      err = scha_control(SCHA_GIVEOVER, resource_group, resource_name);

	      if (err != SCHA_ERR_NOERR) {
		  syslog(LOG_ERR, "scha_control GIVEOVER failed: %s",
		     scha_strerror_i18n(err));
	      }
	 }

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

       scha_calls(3HA), setlocale(3C), syslog(3C), attributes(5)

Sun Cluster 3.2 						    7 Sep 2007							scha_strerror(3HA)