Man page - rpma_log_set_function(3)

Packages contains this manual

Package: librpma-dev
apt-get install librpma-dev

Manuals in package:

Documentations in package:

librpma-dev

Manual

rpma_log_set_function

NAME
SYNOPSIS
DESCRIPTION
THE DEFAULT LOGGING FUNCTION
RETURN VALUE
ERRORS
NOTE
SEE ALSO

NAME

rpma_log_set_function - set the logging function

SYNOPSIS

#include <librpma.h>

typedef void rpma_log_function (
enum rpma_log_level level ,
const char * file_name ,
const int line_no ,
const char * function_name ,
const char * message_format ,
...);

int rpma_log_set_function (rpma_log_function * log_function );

DESCRIPTION

rpma_log_set_function () allows choosing the function which will get all the generated logging messages. The log_function can be either RPMA_LOG_USE_DEFAULT_FUNCTION which will use the default logging function (built into the library) or a pointer to a user-defined function.

Parameters of a user-defined log function are as follow:

	•		level - the log level of the message
	•		file_name - name of the source file where the message coming from. It could be set to NULL and in such case neither line_no nor function_name are provided.
	•		line_no - the source file line where the message coming from
	•		function_name - the function name where the message coming from
	•		message_format - printf (3) -like format string of the message
	•		"..." - additional arguments of the message format string

THE DEFAULT LOGGING FUNCTION

The initial value of the logging function is RPMA_LOG_USE_DEFAULT_FUNCTION. This function writes messages to syslog (3) (the primary destination) and to stderr (3) (the secondary destination).

RETURN VALUE

rpma_log_set_function () function returns 0 on success or error code on failure.

ERRORS

•

RPMA_E_AGAIN - a temporary error occurred, the retry may fix the problem

NOTE

The logging messages on the levels above the RPMA_LOG_THRESHOLD level won’t trigger the logging function.

The user defined function must be thread-safe.