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)