neuray API Programmer's Manual

mi::neuraylib::ILogging_configuration Class Reference

[Configuration Interfaces]

Description

This interface is used for configuring the logging for the . The neuray API allows to configure the logging in several ways. You can control the logging by providing an own logger object that implements the mi::base::ILogger interface. By default, all messages are written to stderr.

There are two types of loggers, forwarding and receiving loggers. From an application point of view the flow of a log message is as follows: The application sends the message to the forwarding logger which forwards it to the . The message is processed, and if not discarded, sent to the logging host (if distinct from the local host), and passed to the receiving logger. Both types of loggers use the same interface mi::base::ILogger. The receiving logger can be set by the application, the forwarding logger cannot be controlled and is provided by the .

The amount of messages can be controlled via log levels. There are two different kinds of log levels, one overall log level, and log levels for individual message categories. These log levels act as independent filters; only messages passing both log level settings are reported.

Note that setting a particular log level implies all higher log levels, e.g., mi::base::MESSAGE_SEVERITY_WARNING includes mi::base::MESSAGE_SEVERITY_ERROR and mi::base::MESSAGE_SEVERITY_FATAL.

In a cluster setup only one host, the logging host, receives the log messages of all hosts. The selection of the logging host is controlled via log priorities.

See also:

mi::base::ILogger for a list of supported message categories

Public Member Functions

virtual base::​ILoggerget_forwarding_logger() const =0
Returns the forwarding logger. More...
virtual base::​Message_severity get_log_level() const =0
Returns the overall logging level of this host. More...
virtual base::​Message_severity get_log_level_by_category( const char* category) const =0
Returns the logging level of this host for a particular message category. More...
virtual Uint32 get_log_prefix() const =0
Returns the log message prefix. More...
virtual Sint32 get_log_priority() const =0
Returns the logging priority of this host.
virtual base::​ILoggerget_receiving_logger() const =0
Returns the receiving logger. More...
virtual Sint32 set_log_level( base::​Message_severity level) =0
Sets the overall logging level of this host. More...
virtual Sint32 set_log_level_by_category( const char* category, base::​Message_severity level) =0
Sets the logging level of this host for a particular message category. More...
virtual void set_log_prefix( Uint32 prefix) =0
Sets the log message prefix. More...
virtual Sint32 set_log_priority( Sint32 priority) =0
Sets the logging priority of this host. More...
virtual void set_receiving_logger( base::​ILogger* logger) =0
Sets the receiving logger. More...

Member Functions

virtual base::​ILogger* mi::​neuraylib::​ILogging_configuration::get_forwarding_logger() const [pure virtual]

Returns the forwarding logger. The forwarding logger should be used to pass log messages to the .

virtual base::​Message_severity mi::​neuraylib::​ILogging_configuration::get_log_level() const [pure virtual]

Returns the overall logging level of this host.

See also:

get_log_level_by_category()

Returns

The configured logging level.

virtual base::​Message_severity mi::​neuraylib::​ILogging_configuration::get_log_level_by_category( const char* category) const [pure virtual]

Returns the logging level of this host for a particular message category.

See also:

mi::base::ILogger for supported categories

get_log_level() for a filter level independent of categories

Parameters

category
The message category.

Returns

The logging level, in case of success, -1 in case of failure.

virtual Uint32 mi::​neuraylib::​ILogging_configuration::get_log_prefix() const [pure virtual]

Returns the log message prefix.

Returns

A bitmask of the enabled log message components (see mi::neuraylib::Log_prefix).

virtual Sint32 mi::​neuraylib::​ILogging_configuration::get_log_priority() const [pure virtual]

Returns the logging priority of this host.

virtual base::​ILogger* mi::​neuraylib::​ILogging_configuration::get_receiving_logger() const [pure virtual]

Returns the receiving logger. Note that if no receiving logger has been set, this method returns NULL and logging is done using a default logger that is internal to this library. This default logger simply writes to stderr.

Note that log messages directly passed to the receiving logger will not be processed by the . Use the forwarding logger instead.

virtual Sint32 mi::​neuraylib::​ILogging_configuration::set_log_level( base::​Message_severity level) [pure virtual]

Sets the overall logging level of this host. Any messages below the given level will be discarded.

See also:

set_log_level_by_category()

Parameters

level
The logging level.

Returns

0, in case of success, -1 in case of failure.

virtual Sint32 mi::​neuraylib::​ILogging_configuration::set_log_level_by_category( const char* category, base::​Message_severity level) [pure virtual]

Sets the logging level of this host for a particular message category. Any messages of that category below the given level will be discarded.

See also:

mi::base::ILogger for supported categories

set_log_level() for a filter level independent of categories

Parameters

category
The message category. The special value "ALL" is supported to set the logging level of all categories.
level
The logging level.

Returns

0, in case of success, -1 in case of failure.

virtual void mi::​neuraylib::​ILogging_configuration::set_log_prefix( Uint32 prefix) [pure virtual]

Sets the log message prefix. The log message prefix consists of several optional components that provide context for the log message. Each of these components can be enabled or disabled.

Parameters

prefix
A bitmask of the to-be-enabled log message components (see mi::neuraylib::Log_prefix).
virtual Sint32 mi::​neuraylib::​ILogging_configuration::set_log_priority( Sint32 priority) [pure virtual]

Sets the logging priority of this host. The log priority determines which host becomes the logging host. The preferred logging host should have the highest number, and fallbacks in case of problems should have lower numbers, in the preferred order of fallbacks. Hosts with the highest logging priority will take over from designated logging hosts that have failed. The default logging priority is 0.

This can only be configured before has been started.

Parameters

priority
The logging priority

Returns

0, in case of success, -1 in case of failure.

virtual void mi::​neuraylib::​ILogging_configuration::set_receiving_logger( base::​ILogger* logger) [pure virtual]

Sets the receiving logger. Note that in a cluster setup only the logging host will receive messages from the . An exception are fatal log messages because due to kind of nature of these messages there is no guarantee that they will reach the logging host. In addition, very few log messages might be received during startup before the host has joined the cluster.

Parameters

logger
The receiving logger. It is valid to pass NULL in which case logging is reset to be done to stderr.