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)