Log API

Data Structures
struct	OSAPI_LogProperty
	Configuration of logging functionality. More...

Typedefs
typedef void(*	OSAPI_Log_write_buffer_T) (const char *buffer, RTI_SIZE_T length)
	Optional user-defined function to output a log/trace buffer.
typedef void(*	OSAPI_LogHandler_T) (void *param, OSAPI_LogEntry_T *entry)
	Optional user-defined function for processing new log messages.

Enumerations
enum	OSAPI_LogVerbosity_T { OSAPI_LOG_VERBOSITY_SILENT = 0 , OSAPI_LOG_VERBOSITY_ERROR = 1 , OSAPI_LOG_VERBOSITY_WARNING = 2 , OSAPI_LOG_VERBOSITY_DEBUG = 3 }
	Logging verbosity. More...

Functions
RTI_BOOL	OSAPI_Log_set_log_handler (OSAPI_LogHandler_T handler, void *param)
	Install a log handler.
RTI_BOOL	OSAPI_Log_get_log_handler (OSAPI_LogHandler_T *handler, void **param)
	Return the current log handler.
RTI_BOOL	OSAPI_Log_set_display_handler (OSAPI_LogDisplay_T handler, void *param)
	Install a display handler.
RTI_BOOL	OSAPI_Log_get_display_handler (OSAPI_LogDisplay_T *handler, void **param)
	Return the current display function.
void	OSAPI_Log_set_verbosity (OSAPI_LogVerbosity_T verbosity)
	Set the log verbosity.
RTI_BOOL	OSAPI_Log_clear (void)
	Clear the log buffer.
void	OSAPI_Log_get_property (struct OSAPI_LogProperty *property)
	Get the current log properties.
RTI_BOOL	OSAPI_Log_set_property (struct OSAPI_LogProperty *property)
	Set the log properties.
OSPSLDllExport RTI_INT32	OSAPI_Log_get_last_error_code (void)
	Returns the error code for a function that failed.

Detailed Description

Typedef Documentation

OSAPI_Log_write_buffer_T

typedef void(* OSAPI_Log_write_buffer_T) (const char *buffer, RTI_SIZE_T length)

Optional user-defined function to output a log/trace buffer.

The handler is set by OSAPI_Log_set_property().

Parameters

[in]	buffer	Pointer to buffer with log to write
[in]	length	Length of the buffer to write

OSAPI_LogHandler_T

typedef void(* OSAPI_LogHandler_T) (void *param, OSAPI_LogEntry_T *entry)

Optional user-defined function for processing new log messages.

Definition of a function that can be installed with the logger and that will be called for each new log event.

The handler is set by OSAPI_Log_set_log_handler().

When called, provides parameters containing the raw log entry and additional optional information.

Parameters

[in]	param	User-defined parameter
[in]	entry	Log entry

Enumeration Type Documentation

OSAPI_LogVerbosity_T

enum OSAPI_LogVerbosity_T

Logging verbosity.

Enumerator
OSAPI_LOG_VERBOSITY_SILENT	Logs are not written.
OSAPI_LOG_VERBOSITY_ERROR	Only error logs are written.
OSAPI_LOG_VERBOSITY_WARNING	Error and warning logs are written.
OSAPI_LOG_VERBOSITY_DEBUG	All logs are written.

Function Documentation

OSAPI_Log_set_log_handler()

RTI_BOOL OSAPI_Log_set_log_handler	(	OSAPI_LogHandler_T	handler,
		void *	param )

Install a log handler.

The log functionality allows the user to specify a log handler. The log handler is a function which is called for every logged event. It is up to the user to decide what to do with the log message. The handler is a global function pointer.

Parameters

[in]	handler	Pointer to log handler function
[in]	param	Parameter passed to the log handler function. This parameter is transparent to the log functionality.

Returns

RTI_TRUE on success, RTI_FALSE on failure

OSAPI_Log_get_log_handler()

RTI_BOOL OSAPI_Log_get_log_handler	(	OSAPI_LogHandler_T *	handler,
		void **	param )

Return the current log handler.

Return the current log handler.

Parameters

[in]	handler	Pointer to store log handler function
[in]	param	Pointer to store the current log handler parameter.

Returns

RTI_TRUE on success, RTI_FALSE on failure

OSAPI_Log_set_display_handler()

RTI_BOOL OSAPI_Log_set_display_handler	(	OSAPI_LogDisplay_T	handler,
		void *	param )

Install a display handler.

The display handler is responsible for outputting log messages to a console.

Parameters

[in]	handler	Pointer to display function
[in]	param	Parameter passed to the display handler function. This parameter is transparent to the log functionality.

Returns

RTI_TRUE on success, RTI_FALSE on failure

OSAPI_Log_get_display_handler()

RTI_BOOL OSAPI_Log_get_display_handler	(	OSAPI_LogDisplay_T *	handler,
		void **	param )

Return the current display function.

Return the current log handler.

Parameters

[in]	handler	Pointer to store display handler function
[in]	param	Pointer to store the current display handler parameters.

Returns

RTI_TRUE on success, RTI_FALSE on failure

OSAPI_Log_set_verbosity()

void OSAPI_Log_set_verbosity

(

OSAPI_LogVerbosity_T

verbosity

)

Set the log verbosity.

Change the log verbosity. The new setting takes immediate effect.

Parameters

[in]

verbosity

New log verbosity

References RTI_UINT32.

OSAPI_Log_clear()

RTI_BOOL OSAPI_Log_clear

(

void

)

Clear the log buffer.

Clear the log buffer, all the current entries are lost.

NOTE: This function must only be called inside a log-handler as it is not thread-safe.

Returns

RTI_TRUE on success, RTI_FALSE on failure

OSAPI_Log_get_property()

void OSAPI_Log_get_property

(

struct OSAPI_LogProperty *

property

)

Get the current log properties.

Return the current log properties

Parameters

[out]

property

- Current log properties

See Also OSAPI_Log_set_property

OSAPI_Log_set_property()

RTI_BOOL OSAPI_Log_set_property

(

struct OSAPI_LogProperty *

property

)

Set the log properties.

Set the current log properties. It is not possible to set new properties after OSAPI_Log_initialize() has been called/

Parameters

[in]

property

New log properties

Returns

RTI_TRUE if new properties can be set, RTI_FALSE otherwise See Also OSAPI_Log_get_property

References RTI_INT32, and RTI_UINT32.

OSAPI_Log_get_last_error_code()

OSPSLDllExport RTI_INT32 OSAPI_Log_get_last_error_code

(

void

)

Returns the error code for a function that failed.

Many functions returns RTI_FALSE or NULL on failure. In order to provide additional information about reason for the failure fucntions may set an additional error code. This function returns the last error-code recorded for the calling thread.

Returns

Last error-code recorded for this thread

References RTI_INT32, RTI_INT64, and RTI_UINT32.