Sun OpenSSO Enterprise 8.0 C API Reference for Application and Web Policy Agent Developers

am_log_set_module_level()

Sets the level for the specified logging module.

Syntax

#include "am_log.h"
AM_EXPORT am_log_level_t
am_log_set_module_level(am_log_module_id_t moduleID,
                        am_log_level_t level);

Parameters

This function takes the following parameters:

moduleID

The identifier of the logging module.

level

The level to which the logging module will be set. Each module has an associated level that defines the amount of detail that will be logged. Possible values are defined in the following enumeration. The default value is AM_LOG_INFO.

typedef enum am_log_level {
    AM_LOG_ALWAYS = -1, /* always logged */
    AM_LOG_NONE,	/* never logged, typically used to turn off a module */
    AM_LOG_ERROR,	/* used for error messages */
    AM_LOG_WARNING,	/* used for warning messages */
    AM_LOG_INFO,	/* used for informational messages */
    AM_LOG_DEBUG,	/* used for debug messages */
    AM_LOG_MAX_DEBUG,    /* used for more detailed debug messages */
    AM_LOG_AUTH_REMOTE = 128, /* logged deny and/or allow */
    AM_LOG_AUTH_LOCAL = 256
} am_log_level_t;

Returns

This function returns am_log_level_t with one of the following values:

The previous logging level of the module.

If the logging level is set properly.

LOG_NONE

If the specified module is invalid.