PipeWire  0.3.59
Logging

Logging functions of PipeWire. More...

Files

file  log.h
 pipewire/log.h
 

Macros

#define PW_LOG_TOPIC_STATIC(var, topic)
 Declare a static log topic named var. More...
 
#define PW_LOG_TOPIC_EXTERN(var)    extern struct spa_log_topic *var
 Declare a static log topic named var. More...
 
#define PW_LOG_TOPIC(var, topic)
 Declare a static log topic named var. More...
 
#define PW_LOG_TOPIC_INIT(var)    spa_log_topic_init(pw_log_get(), var);
 
#define pw_log_level_enabled(lev)   (pw_log_level >= (lev))
 Check if a loglevel is enabled. More...
 
#define pw_log_topic_enabled(lev, t)   ((t) && (t)->has_custom_level ? (t)->level >= (lev) : pw_log_level_enabled((lev)))
 
#define pw_logtv(lev, topic, fmt, ap)
 
#define pw_logt(lev, topic, ...)
 
#define pw_log(lev, ...)   pw_logt(lev,PW_LOG_TOPIC_DEFAULT,__VA_ARGS__)
 
#define pw_log_error(...)   pw_log(SPA_LOG_LEVEL_ERROR,__VA_ARGS__)
 
#define pw_log_warn(...)   pw_log(SPA_LOG_LEVEL_WARN,__VA_ARGS__)
 
#define pw_log_info(...)   pw_log(SPA_LOG_LEVEL_INFO,__VA_ARGS__)
 
#define pw_log_debug(...)   pw_log(SPA_LOG_LEVEL_DEBUG,__VA_ARGS__)
 
#define pw_log_trace(...)   pw_log(SPA_LOG_LEVEL_TRACE,__VA_ARGS__)
 
#define pw_logt_error(t, ...)   pw_logt(SPA_LOG_LEVEL_ERROR,t,__VA_ARGS__)
 
#define pw_logt_warn(t, ...)   pw_logt(SPA_LOG_LEVEL_WARN,t,__VA_ARGS__)
 
#define pw_logt_info(t, ...)   pw_logt(SPA_LOG_LEVEL_INFO,t,__VA_ARGS__)
 
#define pw_logt_debug(t, ...)   pw_logt(SPA_LOG_LEVEL_DEBUG,t,__VA_ARGS__)
 
#define pw_logt_trace(t, ...)   pw_logt(SPA_LOG_LEVEL_TRACE,t,__VA_ARGS__)
 
#define pw_log_trace_fp(...)   pw_log(SPA_LOG_LEVEL_TRACE,__VA_ARGS__)
 

Functions

void pw_log_set (struct spa_log *log)
 Configure a logging module. More...
 
struct spa_logpw_log_get (void)
 Get the log interface. More...
 
void pw_log_set_level (enum spa_log_level level)
 Configure the logging level. More...
 
void pw_log_logt (enum spa_log_level level, const struct spa_log_topic *topic, const char *file, int line, const char *func, const char *fmt,...) 1(6
 Log a message for a topic. More...
 
void void pw_log_logtv (enum spa_log_level level, const struct spa_log_topic *topic, const char *file, int line, const char *func, const char *fmt, va_list args) 1(6
 Log a message for a topic. More...
 
void void void pw_log_log (enum spa_log_level level, const char *file, int line, const char *func, const char *fmt,...) 1(5
 Log a message for the default topic. More...
 
void void void void pw_log_logv (enum spa_log_level level, const char *file, int line, const char *func, const char *fmt, va_list args) 1(5
 Log a message for the default topic. More...
 
void void void void void _pw_log_topic_new (struct spa_log_topic *topic)
 Initialize the log topic. More...
 

Variables

enum spa_log_level pw_log_level
 The global log level. More...
 
struct spa_log_topicPW_LOG_TOPIC_DEFAULT
 

Detailed Description

Logging functions of PipeWire.

Logging is performed to stdout and stderr. Trace logging is performed in a lockfree ringbuffer and written out from the main thread as to not block the realtime threads.

Macro Definition Documentation

◆ PW_LOG_TOPIC_STATIC

#define PW_LOG_TOPIC_STATIC (   var,
  topic 
)

Declare a static log topic named var.

The usual usage is:

#define PW_LOG_TOPIC_DEFAULT my_topic
void foo() {
pw_log_debug("bar");
}
#define PW_LOG_TOPIC_STATIC(var, topic)
Declare a static log topic named var.
Definition: log.h:122
#define pw_log_debug(...)
Definition: log.h:165

◆ PW_LOG_TOPIC_EXTERN

#define PW_LOG_TOPIC_EXTERN (   var)     extern struct spa_log_topic *var

Declare a static log topic named var.

See PW_LOG_TOPIC_STATIC for an example usage.

◆ PW_LOG_TOPIC

#define PW_LOG_TOPIC (   var,
  topic 
)

Declare a static log topic named var.

See PW_LOG_TOPIC_STATIC for an example usage.

◆ PW_LOG_TOPIC_INIT

#define PW_LOG_TOPIC_INIT (   var)     spa_log_topic_init(pw_log_get(), var);

◆ pw_log_level_enabled

#define pw_log_level_enabled (   lev)    (pw_log_level >= (lev))

Check if a loglevel is enabled.

◆ pw_log_topic_enabled

#define pw_log_topic_enabled (   lev,
 
)    ((t) && (t)->has_custom_level ? (t)->level >= (lev) : pw_log_level_enabled((lev)))

◆ pw_logtv

#define pw_logtv (   lev,
  topic,
  fmt,
  ap 
)

◆ pw_logt

#define pw_logt (   lev,
  topic,
  ... 
)

◆ pw_log

#define pw_log (   lev,
  ... 
)    pw_logt(lev,PW_LOG_TOPIC_DEFAULT,__VA_ARGS__)

◆ pw_log_error

◆ pw_log_warn

◆ pw_log_info

◆ pw_log_debug

#define pw_log_debug (   ...)    pw_log(SPA_LOG_LEVEL_DEBUG,__VA_ARGS__)

◆ pw_log_trace

◆ pw_logt_error

#define pw_logt_error (   t,
  ... 
)    pw_logt(SPA_LOG_LEVEL_ERROR,t,__VA_ARGS__)

◆ pw_logt_warn

#define pw_logt_warn (   t,
  ... 
)    pw_logt(SPA_LOG_LEVEL_WARN,t,__VA_ARGS__)

◆ pw_logt_info

#define pw_logt_info (   t,
  ... 
)    pw_logt(SPA_LOG_LEVEL_INFO,t,__VA_ARGS__)

◆ pw_logt_debug

#define pw_logt_debug (   t,
  ... 
)    pw_logt(SPA_LOG_LEVEL_DEBUG,t,__VA_ARGS__)

◆ pw_logt_trace

#define pw_logt_trace (   t,
  ... 
)    pw_logt(SPA_LOG_LEVEL_TRACE,t,__VA_ARGS__)

◆ pw_log_trace_fp

#define pw_log_trace_fp (   ...)    pw_log(SPA_LOG_LEVEL_TRACE,__VA_ARGS__)

Function Documentation

◆ pw_log_set()

void pw_log_set ( struct spa_log log)

Configure a logging module.

This is usually done automatically in pw_init() but you can install a custom logger before calling pw_init().

Configure a logging module.

Parameters
logthe global log to set

◆ pw_log_get()

struct spa_log* pw_log_get ( void  )

Get the log interface.

Get the log interface.

Returns
the global log

◆ pw_log_set_level()

void pw_log_set_level ( enum spa_log_level  level)

Configure the logging level.

Configure the logging level.

Parameters
levelthe new log level

◆ pw_log_logt()

void pw_log_logt ( enum spa_log_level  level,
const struct spa_log_topic topic,
const char *  file,
int  line,
const char *  func,
const char *  fmt,
  ... 
)

Log a message for a topic.

◆ pw_log_logtv()

void void pw_log_logtv ( enum spa_log_level  level,
const struct spa_log_topic topic,
const char *  file,
int  line,
const char *  func,
const char *  fmt,
va_list  args 
)

Log a message for a topic.

◆ pw_log_log()

void void void pw_log_log ( enum spa_log_level  level,
const char *  file,
int  line,
const char *  func,
const char *  fmt,
  ... 
)

Log a message for the default topic.

◆ pw_log_logv()

void void void void pw_log_logv ( enum spa_log_level  level,
const char *  file,
int  line,
const char *  func,
const char *  fmt,
va_list  args 
)

Log a message for the default topic.

◆ _pw_log_topic_new()

void void void void void _pw_log_topic_new ( struct spa_log_topic topic)

Initialize the log topic.

The returned topic is owned by the pipewire context and the topic must not be modified or freed. Do not use this function directly, use one of PW_LOG_TOPIC_* instead.

See also
PW_LOG_TOPIC_STATIC
PW_LOG_TOPIC_EXTERN
PW_LOG_TOPIC

Variable Documentation

◆ pw_log_level

enum spa_log_level pw_log_level
extern

The global log level.

◆ PW_LOG_TOPIC_DEFAULT

struct spa_log_topic* PW_LOG_TOPIC_DEFAULT
extern