Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018
 
 

scds_syslog_debug (3HA)

Name

scds_syslog_debug - write a debugging message to the system log

Synopsis

cc [flags…] –I /usr/cluster/include file –L /usr/cluster/lib 
     –l dsdev#include <rgm/libdsdev.h>voidscds_syslog_debug(int 
     debug_level, constchar *format...

Description

The scds_syslog_debug() function writes a debugging message to the system log. It uses the facility returned by the scha_cluster_getlogfacility(3HA) function.

All syslog messages are prefixed with the following:

SC[<resourceTypeName>,<resourceGroupName>,<resourceName>,<methodName>

If you specify a debug_level greater than the current debugging level being used, no information is written.

The DSDL defines the maximum debugging level, SCDS_MAX_DEBUG_LEVEL, as 9. The scds_initialize(3HA) function, which the calling program must call before scds_syslog_debug(), retrieves the current debugging level from the file: /var/cluster/rgm/rt/<resourceTypeName>/loglevel.


Caution

Caution  -  Messages written to the system log are not internationalized. Do not use gettext() or other message translation functions in conjunction with this function.


Parameters

The following parameters are supported:

debug_level

Debugging level at which this message is to be written. Valid debugging levels are between 1 and SCDS_MAX_DEBUG_LEVEL, which is defined as 9 by the DSDL. If the specified debugging level is greater than the debugging level set by the calling program, the message is not written to the system log.

format

Message format string, as specified by printf(3C)

...

Variables, indicated by the format parameter, as specified by printf(3C)

Examples

Example 1 Display All Debugging Messages

To see all debugging messages for resource type SUNW.iws, issue the following command on all nodes of your cluster:

echo 9 > /var/cluster/rgm/rt/SUNW.iws/loglevel
Example 2 Suppress Debugging Messages

To suppress debugging messages for resource type SUNW.iws, issue the following command on all nodes of your cluster:

echo 0 > /var/cluster/rgm/rt/SUNW.iws/loglevel

Files

/usr/cluster/include/rgm/libdsdev.h

Include file

/usr/cluster/lib/libdsdev.so

Library

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
ha-cluster/developer/api
Interface Stability
Evolving

See Also

printf(3C), syslog(3C), scds_syslog(3HA), scha_cluster_getlogfacility(3HA), syslog.conf(5), attributes(7)