Home | History | Annotate | Download | only in man3ha
 te
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License"). 
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
 Copyright 2007 Sun Microsystems, Inc. All
 rights reserved. Use is subject to license terms.
 scds_syslog_debug 3HA "7 Sep 2007" "Sun Cluster 3.2" "Sun Cluster HA and Data Services"
 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>

void  scds_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: 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 - 


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:


.na
debug_level
.ad


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.





.na
format
.ad


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





.na
...
.ad


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

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


Include file





.na
/usr/cluster/lib/libdsdev.so
.ad


Library




 ATTRIBUTES

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







ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWscdev
Interface StabilityEvolving



 SEE ALSO

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