Tizen Native API  5.5

Full-featured logging system.

Eina provides eina_log_print(), a standard function to manage all logging messages. This function may be called directly or using the helper macros such as EINA_LOG_DBG(), EINA_LOG_ERR() or those that take a specific domain as argument EINA_LOG_DOM_DBG(), EINA_LOG_DOM_ERR(). Internally, eina_log_print() will call the function defined with eina_log_print_cb_set(), that defaults to eina_log_print_cb_stderr(), but may be changed to do whatever you need, such as networking or syslog logging.

The logging system is thread safe once initialized with eina_log_threads_enable(). The thread that calls this function first is considered "main thread" and other threads will have their thread id (pthread_self()) printed in the log message so it is easy to detect from where it is coming.

Log domains is the Eina way to differentiate messages. There might be different domains to represent different modules, different feature-set, different categories and so on. Filtering can be applied to domain names by means of EINA_LOG_LEVELS environment variable or eina_log_domain_level_set().

The different logging levels serve to customize the amount of debugging one want to take and may be used to automatically call abort() once some given level message is printed. This is controlled by environment variable EINA_LOG_ABORT and the level to be considered critical with EINA_LOG_ABORT_LEVEL. These can be changed with eina_log_abort_on_critical_set() and eina_log_abort_on_critical_level_set().

The default maximum level to print is defined by environment variable EINA_LOG_LEVEL, but may be set per-domain with EINA_LOG_LEVELS. It will default to EINA_LOG_ERR. This can be changed with eina_log_level_set().

To use the log system Eina must be initialized with eina_init() and later shut down with eina_shutdown(). Here is a straightforward example:

//Compile with:
//gcc -Wall -o eina_log_01 eina_log_01.c `pkg-config --cflags --libs eina`

#include <stdlib.h>
#include <stdio.h>

#include <Eina.h>

void test_warn(void)
{
   EINA_LOG_WARN("Here is a warning message");
}

int main(void)
{
   if (!eina_init())
     {
        printf("log during the initialization of Eina_Log module\n");
        return EXIT_FAILURE;
     }

   eina_log_level_set(EINA_LOG_LEVEL_WARN);

   test_warn();

   eina_shutdown();

   return EXIT_SUCCESS;
}

Compile this code with the following command:

gcc -Wall -o eina_log_01 eina_log_01.c `pkg-config --cflags --libs eina`

Now execute the program with:

EINA_LOG_LEVEL=2 ./eina_log_01

You should see a message displayed in the terminal.

For more information, you can look at the Log Tutorial.

Functions

void eina_log_threads_enable (void)
void eina_log_print_cb_set (Eina_Log_Print_Cb cb, void *data)
void eina_log_level_set (int level)
 Sets the default log level.
int eina_log_level_get (void)
 Gets the default log level.
static Eina_Bool eina_log_level_check (int level)
 Determines if a given level should be logged.
Eina_Bool eina_log_main_thread_check (void)
 Checks if current thread is the main thread.
void eina_log_color_disable_set (Eina_Bool disabled)
 Enables or disables colored text in the logs.
Eina_Bool eina_log_color_disable_get (void)
 Determines if color logging is enabled or disabled.
void eina_log_file_disable_set (Eina_Bool disabled)
 Sets if originating file name logging should be disabled.
Eina_Bool eina_log_file_disable_get (void)
 Gets if originating file name logging should be disabled.
void eina_log_function_disable_set (Eina_Bool disabled)
 Sets if originating function name logging should be disabled.
Eina_Bool eina_log_function_disable_get (void)
 Gets if originating function name logging should be disabled.
void eina_log_abort_on_critical_set (Eina_Bool abort_on_critical)
 Sets if critical messages should abort the program.
Eina_Bool eina_log_abort_on_critical_get (void)
 Gets if critical messages should abort the program.
void eina_log_abort_on_critical_level_set (int critical_level)
 Sets level that triggers abort if abort-on-critical is set.
int eina_log_abort_on_critical_level_get (void)
 Gets level that triggers abort if abort-on-critical is set.
void eina_log_domain_level_set (const char *domain_name, int level)
 Sets the domain level given its name.
int eina_log_domain_level_get (const char *domain_name)
 Gets the domain level given its name.
int eina_log_domain_registered_level_get (int domain)
 Gets the domain level given its identifier.
void eina_log_domain_registered_level_set (int domain, int level)
 Sets the domain level given its identifier.
int eina_log_domain_register (const char *name, const char *color)
void eina_log_domain_unregister (int domain)
 Forgets about a logging domain registered by eina_log_domain_register()
void eina_log_print (int domain, Eina_Log_Level level, const char *file, const char *function, int line, const char *fmt,...)
 Prints out log message using given domain and level.
void eina_log_vprint (int domain, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, va_list args)
 Prints out log message using given domain and level.
void eina_log_print_cb_stdout (const Eina_Log_Domain *d, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, void *data, va_list args)
 Alternative logging method, this will output to standard output stream.
void eina_log_print_cb_stderr (const Eina_Log_Domain *d, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, void *data, va_list args)
 Default logging method, this will output to standard error stream.
void eina_log_print_cb_file (const Eina_Log_Domain *d, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, void *data, va_list args)
 Alternative logging method, this will output to given file stream.
void eina_log_print_cb_journald (const Eina_Log_Domain *d, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, void *data, va_list args)
 Alternative logging function, this outputs to the system log.
void eina_log_console_color_set (FILE *fp, const char *color)
 Configures console color of given file.
void eina_log_timing (int domain, Eina_Log_State state, const char *phase)
 Starts or stops the timing of a phase.

Typedefs

typedef struct _Eina_Log_Domain Eina_Log_Domain
typedef enum _Eina_Log_Level Eina_Log_Level
typedef void(* Eina_Log_Print_Cb )(const Eina_Log_Domain *d, Eina_Log_Level level, const char *file, const char *fnc, int line, const char *fmt, void *data, va_list args)
typedef enum _Eina_Log_State Eina_Log_State

Defines

#define EINA_LOG_DOMAIN_DEFAULT   EINA_LOG_DOMAIN_GLOBAL
#define EINA_LOG(DOM, LEVEL, fmt,...)   do { (void) DOM; (void) LEVEL; (void) fmt; } while (0)
#define EINA_LOG_DOM_CRIT(DOM, fmt,...)   EINA_LOG(DOM, EINA_LOG_LEVEL_CRITICAL, fmt, ## __VA_ARGS__)
#define EINA_LOG_DOM_ERR(DOM, fmt,...)   EINA_LOG(DOM, EINA_LOG_LEVEL_ERR, fmt, ## __VA_ARGS__)
#define EINA_LOG_DOM_INFO(DOM, fmt,...)   EINA_LOG(DOM, EINA_LOG_LEVEL_INFO, fmt, ## __VA_ARGS__)
#define EINA_LOG_DOM_DBG(DOM, fmt,...)   EINA_LOG(DOM, EINA_LOG_LEVEL_DBG, fmt, ## __VA_ARGS__)
#define EINA_LOG_DOM_WARN(DOM, fmt,...)   EINA_LOG(DOM, EINA_LOG_LEVEL_WARN, fmt, ## __VA_ARGS__)
#define EINA_LOG_CRIT(fmt,...)
#define EINA_LOG_ERR(fmt,...)   EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_ERR, fmt, ## __VA_ARGS__)
#define EINA_LOG_INFO(fmt,...)   EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_INFO, fmt, ## __VA_ARGS__)
#define EINA_LOG_WARN(fmt,...)   EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_WARN, fmt, ## __VA_ARGS__)
#define EINA_LOG_DBG(fmt,...)   EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_DBG, fmt, ## __VA_ARGS__)
#define EINA_LOG_STATE_INIT   _eina_log_state_init
#define EINA_LOG_STATE_SHUTDOWN   _eina_log_state_shutdown

Define Documentation

#define EINA_LOG (   DOM,
  LEVEL,
  fmt,
  ... 
)    do { (void) DOM; (void) LEVEL; (void) fmt; } while (0)

Logs a message on the specified domain, level and format.

Note:
If EINA_LOG_LEVEL_MAXIMUM is defined, then messages larger than this value will be ignored regardless of current domain level, the eina_log_print() is not even called! Most compilers will just detect the two integers make the branch impossible and remove the branch and function call all together. Take this as optimization tip and possible remove debug messages from binaries to be deployed, saving on hot paths. Never define EINA_LOG_LEVEL_MAXIMUM on public header files.
#define EINA_LOG_CRIT (   fmt,
  ... 
)
Value:

Logs a message with level CRITICAL on the default domain with the specified format.

#define EINA_LOG_DBG (   fmt,
  ... 
)    EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_DBG, fmt, ## __VA_ARGS__)

Logs a message with level DEBUG on the default domain with the specified format.

Examples:
eina_log_02.c.
#define EINA_LOG_DOM_CRIT (   DOM,
  fmt,
  ... 
)    EINA_LOG(DOM, EINA_LOG_LEVEL_CRITICAL, fmt, ## __VA_ARGS__)

Logs a message with level CRITICAL on the specified domain and format.

#define EINA_LOG_DOM_DBG (   DOM,
  fmt,
  ... 
)    EINA_LOG(DOM, EINA_LOG_LEVEL_DBG, fmt, ## __VA_ARGS__)

Logs a message with level DEBUG on the specified domain and format.

#define EINA_LOG_DOM_ERR (   DOM,
  fmt,
  ... 
)    EINA_LOG(DOM, EINA_LOG_LEVEL_ERR, fmt, ## __VA_ARGS__)

Logs a message with level ERROR on the specified domain and format.

#define EINA_LOG_DOM_INFO (   DOM,
  fmt,
  ... 
)    EINA_LOG(DOM, EINA_LOG_LEVEL_INFO, fmt, ## __VA_ARGS__)

Logs a message with level INFO on the specified domain and format.

#define EINA_LOG_DOM_WARN (   DOM,
  fmt,
  ... 
)    EINA_LOG(DOM, EINA_LOG_LEVEL_WARN, fmt, ## __VA_ARGS__)

Logs a message with level WARN on the specified domain and format.

This macro defines the domain to use with the macros EINA_LOG_DOM_DBG(), EINA_LOG_DOM_INFO(), EINA_LOG_DOM_WARN(), EINA_LOG_DOM_ERR() and EINA_LOG_DOM_CRIT().

If not defined prior to the inclusion of this header, then it defaults to EINA_LOG_DOMAIN_GLOBAL.

Note:
One may like to redefine this in its code to avoid typing too much. In this case the recommended way is:
 #include <Eina.h>
 #undef EINA_LOG_DOMAIN_DEFAULT
 #define EINA_LOG_DOMAIN_DEFAULT _log_dom
 static int _log_dom = -1;

 int main(void)
 {
    eina_init();
    _log_dom = eina_log_domain_register("mydom", EINA_COLOR_CYAN);
    EINA_LOG_ERR("using my own domain");
    return 0;
 }
Warning:
If one defines the domain prior to inclusion of this header, the defined log domain symbol must be defined prior as well, otherwise the inlined functions defined by Eina will fail to find the symbol, causing build failure.
 #define EINA_LOG_DOMAIN_DEFAULT _log_dom
 static int _log_dom = -1; // must come before inclusion of Eina.h!
 #include <Eina.h>

 int main(void)
 {
    eina_init();
    _log_dom = eina_log_domain_register("mydom", EINA_COLOR_CYAN);
    EINA_LOG_ERR("using my own domain");
    return 0;
 }
#define EINA_LOG_ERR (   fmt,
  ... 
)    EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_ERR, fmt, ## __VA_ARGS__)

Logs a message with level ERROR on the default domain with the specified format.

Examples:
eina_log_02.c, and eina_simple_xml_parser_01.c.
#define EINA_LOG_INFO (   fmt,
  ... 
)    EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_INFO, fmt, ## __VA_ARGS__)

Logs a message with level INFO on the default domain with the specified format.

Examples:
eina_log_02.c, and eina_log_03.c.

String that indicates the log system is initializing

Since :
3.0

String that indicates the log system is initializing

String that indicates the log system is shutting down

#define EINA_LOG_WARN (   fmt,
  ... 
)    EINA_LOG(EINA_LOG_DOMAIN_DEFAULT, EINA_LOG_LEVEL_WARN, fmt, ## __VA_ARGS__)

Logs a message with level WARN on the default domain with the specified format.

Examples:
eina_log_01.c.

Typedef Documentation

The domain used for logging.

List of available logging levels.

Type for print callbacks.

List of available log states.


Enumeration Type Documentation

List of available logging levels.

Enumerator:
EINA_LOG_LEVEL_CRITICAL 

Critical log level

EINA_LOG_LEVEL_ERR 

Error log level

EINA_LOG_LEVEL_WARN 

Warning log level

EINA_LOG_LEVEL_INFO 

Information log level

EINA_LOG_LEVEL_DBG 

Debug log level

EINA_LOG_LEVELS 

Count of default log levels

EINA_LOG_LEVEL_UNKNOWN 

Unknown level

List of available log states.


Function Documentation

Gets if critical messages should abort the program.

Returns:
If EINA_TRUE, any messages with level equal or smaller than eina_log_abort_on_critical_level_get() will abort the program.
See also:
eina_log_abort_on_critical_set()
eina_log_abort_on_critical_level_set()
Since :
3.0f(2.3.1)

Gets level that triggers abort if abort-on-critical is set.

Returns:
Critical level equal or smaller than value will trigger program abortion if eina_log_abort_on_critical_get() returns EINA_TRUE.
See also:
eina_log_abort_on_critical_level_set()
eina_log_abort_on_critical_get()
Since :
3.0f(2.3.1)
void eina_log_abort_on_critical_level_set ( int  critical_level)

Sets level that triggers abort if abort-on-critical is set.

Parameters:
[in]critical_levelLevels equal or smaller than the given value will trigger program abortion if eina_log_abort_on_critical_get() returns EINA_TRUE.
Note:
this is initially set to envvar EINA_LOG_ABORT_LEVEL by eina_init().
See also:
eina_log_abort_on_critical_level_get()
eina_log_abort_on_critical_get()
Since :
3.0f(2.3.1)
void eina_log_abort_on_critical_set ( Eina_Bool  abort_on_critical)

Sets if critical messages should abort the program.

Parameters:
[in]abort_on_criticalIf EINA_TRUE, messages with level equal or smaller than eina_log_abort_on_critical_level_get() will abort the program.
Note:
this is initially set to envvar EINA_LOG_ABORT by eina_init().
See also:
eina_log_abort_on_critical_get()
eina_log_abort_on_critical_level_set()
Since :
3.0f(2.3.1)

Determines if color logging is enabled or disabled.

Returns:
If EINA_TRUE, color logging is disabled.
See also:
eina_log_color_disable_set()
Since :
3.0f(2.3.1)

Enables or disables colored text in the logs.

Parameters:
[in]disabledIf EINA_TRUE, color logging should be disabled.
Note:
this is initially set to envvar EINA_LOG_COLOR_DISABLE by eina_init().
See also:
eina_log_color_disable_get()
Since :
3.0f(2.3.1)
void eina_log_console_color_set ( FILE *  fp,
const char *  color 
)

Configures console color of given file.

Parameters:
[in]fpFile to configure console color (usually stderr or stdout).
[in]colorA VT color code such as EINA_COLOR_RED or EINA_COLOR_RESET.
Note:
If color is disabled, nothing is done. See eina_log_color_disable_get()
On windows, both fp and color is converted automatically.
Since (EFL) :
1.7
Since :
3.0f(2.3.1)
int eina_log_domain_level_get ( const char *  domain_name)

Gets the domain level given its name.

Parameters:
[in]domain_nameDomain name to retrieve the level. It may be of a still not registered domain. If the domain is not registered yet, but there is a pending value, either from eina_log_domain_level_set(),EINA_LOG_LEVELS environment variable or from EINA_LOG_LEVELS_GLOB, these are returned. If nothing else was found, then the global/default level (eina_log_level_get()) is returned.
Returns:
Level to use to limit eina_log_print() for given domain. On error (domain_name == NULL), EINA_LOG_LEVEL_UNKNOWN is returned.
See also:
eina_log_domain_level_set()
eina_log_domain_registered_level_get()
Since :
3.0f(2.3.1)
void eina_log_domain_level_set ( const char *  domain_name,
int  level 
)

Sets the domain level given its name.

This call has the same effect as setting EINA_LOG_LEVELS=<domain_name>:<level>

Parameters:
[in]domain_nameDomain name to change the level. It may be of a still not registered domain. If the domain is not registered yet, it will be saved as a pending set and applied upon registration.
[in]levelLevel to use to limit eina_log_print() for given domain.
Since :
3.0
int eina_log_domain_register ( const char *  name,
const char *  color 
)
Parameters:
[in]nameDomain name
[in]colorColor of the domain name
Returns:
Domain index that will be used as the DOMAIN parameter on log macros. A negative return value means an error occurred.
Note:
MT: Safe to call from any thread.
Since :
3.0

Gets the domain level given its identifier.

Parameters:
[in]domainIdentifier, so it must be previously registered with eina_log_domain_register(). It's a much faster version of eina_log_domain_level_get(), but relies on domain being present.
Returns:
EINA_TRUE if level should be printed, EINA_FALSE if not. (domain's level is greater or equal level).
Since :
3.0f(2.3.1)
void eina_log_domain_registered_level_set ( int  domain,
int  level 
)

Sets the domain level given its identifier.

Parameters:
[in]domainIdentifier, so it must be previously registered with eina_log_domain_register(). It's a much faster version of eina_log_domain_level_get(), but relies on domain being present.
[in]levelLevel to use to limit eina_log_print() for given domain.
Since (EFL) :
1.10
Since :
3.0f(2.3.1)
void eina_log_domain_unregister ( int  domain)

Forgets about a logging domain registered by eina_log_domain_register()

Parameters:
[in]domainDomain identifier as reported by eina_log_domain_register(), must be >= 0.
Note:
MT: Safe to call from any thread.
Since :
3.0

Gets if originating file name logging should be disabled.

Returns:
If EINA_TRUE, file name logging should be disabled.
See also:
eina_log_file_disable_set()
Since :
3.0f(2.3.1)

Sets if originating file name logging should be disabled.

Parameters:
[in]disabledIf EINA_TRUE, file name logging should be disabled.
Note:
this is initially set to envvar EINA_LOG_FILE_DISABLE by eina_init().
See also:
eina_log_file_disable_get()
Since :
3.0f(2.3.1)

Gets if originating function name logging should be disabled.

Returns:
If EINA_TRUE, function name logging should be disabled.
See also:
eina_log_function_disable_set()
Since :
3.0f(2.3.1)

Sets if originating function name logging should be disabled.

Parameters:
[in]disabledIf EINA_TRUE, function name logging should be disabled.
Note:
this is initially set to envvar EINA_LOG_FUNCTION_DISABLE by eina_init().
See also:
eina_log_function_disable_get()
Since :
3.0f(2.3.1)
static Eina_Bool eina_log_level_check ( int  level) [static]

Determines if a given level should be logged.

Parameters:
[in]levelThe log level to check
Returns:
EINA_TRUE if the level should be logged, else EINA_FALSE.
See also:
eina_log_level_set()
int eina_log_level_get ( void  )

Gets the default log level.

Returns:
The log level that limits eina_log_print().
See also:
eina_log_level_set()
Since :
3.0f(2.3.1)
void eina_log_level_set ( int  level)

Sets the default log level.

Parameters:
[in]levelThe log level.

This function sets the log level level. It is used in eina_log_print().

Note:
this is initially set to envvar EINA_LOG_LEVEL by eina_init().
See also:
eina_log_level_get()
Since :
3.0f(2.3.1)
Examples:
eina_log_01.c, and eina_log_02.c.

Checks if current thread is the main thread.

If there is no thread support (compiled with --disable-pthreads) or threads were not enabled, then EINA_TRUE is returned. The only case where EINA_FALSE is returned is when threads were successfully enabled but the current thread is not the one that called eina_log_threads_init() (the main thread).

Returns:
EINA_TRUE if the current thread is the one that called eina_log_threads_init(), otherwise EINA_FALSE.
Since :
3.0f(2.3.1)
void eina_log_print ( int  domain,
Eina_Log_Level  level,
const char *  file,
const char *  function,
int  line,
const char *  fmt,
  ... 
)

Prints out log message using given domain and level.

Note:
Usually you'll not use this function directly but the helper macros EINA_LOG(), EINA_LOG_DOM_CRIT(), EINA_LOG_CRIT() and so on. See eina_log.h
Parameters:
[in]domainLogging domain to use or EINA_LOG_DOMAIN_GLOBAL if you registered none. It is recommended that modules and applications have their own logging domain.
[in]levelMessage level, those with level greater than user specified value (eina_log_level_set() or environment variables EINA_LOG_LEVEL, EINA_LOG_LEVELS) will be ignored.
[in]fileFilename that originated the call, must not be NULL.
[in]functionFunction that originated the call, must not be NULL.
[in]lineOriginating line in file.
[in]fmtPrintf-like format to use. Should not provide trailing '
' as it is automatically included.
[in]...Variadic args.
Note:
MT: This function may be called from different threads if eina_log_threads_enable() was called before.
Since :
3.0f(2.3.1)
void eina_log_print_cb_file ( const Eina_Log_Domain d,
Eina_Log_Level  level,
const char *  file,
const char *  fnc,
int  line,
const char *  fmt,
void *  data,
va_list  args 
)

Alternative logging method, this will output to given file stream.

Parameters:
dThe domain.
levelNot used.
fileThe file which is logged.
fncThe function which is logged.
lineThe line which is logged.
fmtThe output format to use.
dataThe file which will store the output (as a FILE *).
argsThe arguments needed by the format.

This method will never output color.

Note:
MT: If threads are enabled, this function is called within locks.
MT: Threads different from main thread will have thread id appended to domain name.
Since :
3.0f(2.3.1)
void eina_log_print_cb_journald ( const Eina_Log_Domain d,
Eina_Log_Level  level,
const char *  file,
const char *  fnc,
int  line,
const char *  fmt,
void *  data,
va_list  args 
)

Alternative logging function, this outputs to the system log.

This function never gives color as the output.

Parameters:
[in]dThe domain
[in]levelNot used
[in]fileThe file that is logged
[in]fncThe function that is logged
[in]lineThe line that is logged
[in]fmtThe output format to use
[in]dataNot Used
[in]argsThe arguments needed by the format Alternative logging method, this will output to systemd journal.
dThe domain.
levelNot used.
fileThe file which is logged.
fncThe function which is logged.
lineThe line which is logged.
fmtThe output format to use.
dataThe file which will store the output (as a FILE *).
argsThe arguments needed by the format.

This method will never output color.

Note:
If systemd journal is not there it will display error on stderr.
If the process has been started by systemd this will be the default logging method.
Since (EFL) :
1.8
Since :
3.0f(2.3.1)
void eina_log_print_cb_set ( Eina_Log_Print_Cb  cb,
void *  data 
)

Sets logging method to use.

Parameters:
[in]cbThe callback to call when printing a log.
[in]dataThe data to pass to the callback.

By default, eina_log_print_cb_stderr() is used.

Note:
MT: Safe to call from any thread.
MT: Given function cb will be called protected by mutex. This means you're safe from other calls but you should never call eina_log_print(), directly or indirectly.
Since :
3.0f(2.3.1)
Examples:
eina_log_03.c.
void eina_log_print_cb_stderr ( const Eina_Log_Domain d,
Eina_Log_Level  level,
const char *  file,
const char *  fnc,
int  line,
const char *  fmt,
void *  data,
va_list  args 
)

Default logging method, this will output to standard error stream.

Parameters:
dThe domain.
levelThe level.
fileThe file which is logged.
fncThe function which is logged.
lineThe line which is logged.
fmtThe output format to use.
dataNot used.
argsThe arguments needed by the format.

This method will colorize output based on domain provided color and message logging level.

To disable color, set environment variable EINA_LOG_COLOR_DISABLE=1. To enable color, even if directing to a file or when using a non-supported color terminal, use EINA_LOG_COLOR_DISABLE=0. If EINA_LOG_COLOR_DISABLE is unset (or -1), then Eina will disable color if terminal ($TERM) is unsupported or if redirecting to a file. Similarly, to disable file and line information, set EINA_LOG_FILE_DISABLE=1 or EINA_LOG_FUNCTION_DISABLE=1 to avoid function name in output. It is not acceptable to have both EINA_LOG_FILE_DISABLE and EINA_LOG_FUNCTION_DISABLE at the same time, in this case just EINA_LOG_FUNCTION_DISABLE will be considered and file information will be printed anyways.

Note:
MT: If threads are enabled, this function is called within locks.
MT: Threads different from main thread will have thread id appended to domain name.
Since :
3.0f(2.3.1)
void eina_log_print_cb_stdout ( const Eina_Log_Domain d,
Eina_Log_Level  level,
const char *  file,
const char *  fnc,
int  line,
const char *  fmt,
void *  data,
va_list  args 
)

Alternative logging method, this will output to standard output stream.

Parameters:
dThe domain.
levelThe level.
fileThe file which is logged.
fncThe function which is logged.
lineThe line which is logged.
fmtThe output format to use.
dataNot used.
argsThe arguments needed by the format.

This method will colorize output based on domain provided color and message logging level. To disable color, set environment variable EINA_LOG_COLOR_DISABLE=1. Similarly, to disable file and line information, set EINA_LOG_FILE_DISABLE=1 or EINA_LOG_FUNCTION_DISABLE=1 to avoid function name in output. It is not acceptable to have both EINA_LOG_FILE_DISABLE and EINA_LOG_FUNCTION_DISABLE at the same time, in this case just EINA_LOG_FUNCTION_DISABLE will be considered and file information will be printed anyways.

Note:
MT: If threads are enabled, this function is called within locks.
MT: Threads different from main thread will have thread id appended to domain name.
Since :
3.0f(2.3.1)
void eina_log_threads_enable ( void  )

Enable logging module to handle threads.

There is no disable option on purpose, if it is enabled, there is no way back until you call the last eina_shutdown().

There is no function to retrieve if threads are enabled as one is not supposed to know this from outside.

After this call is executed at least once, if Eina was compiled with threads support then logging will lock around debug messages and threads that are not the main thread will have its identifier printed.

The main thread is considered the thread where the first eina_init() was called.

Since :
3.0f(2.3.1)
void eina_log_timing ( int  domain,
Eina_Log_State  state,
const char *  phase 
)

Starts or stops the timing of a phase.

Parameters:
[in]domainThe domain.
[in]stateState indicating if we are starting or stopping a phase.
[in]phaseThe name of the phase to be used in the log.
Note:
One domain can be in only one phase at a time.
If you change the name of the phase, it is assumed that the previous phase has stopped.
The phase name should be available for all the life of the timing.
Since (EFL) :
1.8
Since :
3.0f(2.3.1)
void eina_log_vprint ( int  domain,
Eina_Log_Level  level,
const char *  file,
const char *  fnc,
int  line,
const char *  fmt,
va_list  args 
)

Prints out log message using given domain and level.

Note:
Usually you'll not use this function directly but the helper macros EINA_LOG(), EINA_LOG_DOM_CRIT(), EINA_LOG_CRIT() and so on. See eina_log.h
Parameters:
[in]domainLogging domain to use or EINA_LOG_DOMAIN_GLOBAL if you registered none. It is recommended that modules and applications have their own logging domain.
[in]levelMessage level, those with level greater than user specified value (eina_log_level_set() or environment variables EINA_LOG_LEVEL, EINA_LOG_LEVELS) will be ignored.
[in]fileFilename that originated the call, must not be NULL.
[in]fncFunction that originated the call, must not be NULL.
[in]lineOriginating line in file.
[in]fmtPrintf-like format to use. Should not provide trailing '
' as it is automatically included.
[in]argsThe arguments needed by the format.
Note:
MT: this function may be called from different threads if eina_log_threads_enable() was called before.
See also:
eina_log_print()
Since :
3.0f(2.3.1)

Variable Documentation

const char * _eina_log_state_init

String that indicates the log system is initializing.

Since :
3.0f(2.3.1)

String that indicates the log system is shutting down.

Since :
3.0f(2.3.1)

String that indicates the log system is shutting down.

Since :
3.0

EINA_LOG_DOMAIN_GLOBAL is the general purpose log domain to be used, it is always registered and available everywhere.

Since :
3.0f(2.3.1)