Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### 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:

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`(5) for descriptions of the following attributes:

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

## See Also

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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |