mutek/printk.h header reference
[Kernel services module]

The source code of this header can be browsed online.

Description [link] 

Debugging messages output API

Members [link] 

Types [link] 

Functions [link] 

  • void hexdumpk(uintptr_t address, const void *data, size_t len)
  • void logk_set_filter(struct printk_backend_s *backend, const char id[4], enum logk_level_e level)
  • ssize_t printk(const char *format, ...)
  • void printk_fatal_abort(void )
  • void printk_register(struct printk_backend_s *s, printk_handler_t *handler)
  • void printk_unregister(struct printk_backend_s *s)
  • ssize_t vprintk(const char *format, va_list ap)
  • void writek(const char *data, size_t len)
  • ssize_t logk_(const char *format, ...)
  • ssize_t vlogk_(const char *format, va_list ap)

Macros [link] 

Members detail [link] 

#define GCT_CONTAINER_ALGO_printk_backend [link] 

This macro is declared in mutek/printk.h source file, line 17.

#define GCT_CONTAINER_LOCK_printk_backend [link] 

This macro is declared in mutek/printk.h source file, line 18.

#define LOGK_COLOR(x) [link] 

This macro is declared in mutek/printk.h source file, line 125.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK_COLOR )

#define LOGK_MODULE_ID [link] 

This macro is declared in mutek/printk.h source file, line 22.

A four characters logk module id defined for the current compilation unit.

Alternate declarations with same identifier: [1], [2].

Preprocessor condition: not defined( LOGK_MODULE_ID )

#define MUTEK_PRINTK_H_ [link] 

This macro is declared in mutek/printk.h source file, line 8.

#define PRINTK_HANDLER(n) [link] 

This macro is declared in mutek/printk.h source file, line 42.

See also printk_handler_t.

#define PRINTK_RET(val, ...) [link] 

This macro is declared in mutek/printk.h source file, line 200.

This macro sends a line to the printk backends with the LOGK_LEVEL_ERROR level, then aborts if #CONFIG_MUTEK_PRINTK_FATAL_ABORT is set

void hexdumpk(uintptr_t address, const void *data, size_t len) [link] 

This function is declared in mutek/printk.h source file, line 107.

This function prints a binary memory dump of memory to the backends. Output is terminal-protected (all characters between ascii(0) and ascii(31) are replaced by "." in output).

Address appearing on the side of the dump can be defined.

Output is not filtered according to the log level.

This is available when CONFIG_MUTEK_PRINTK_HEXDUMP is defined.

#define hexdumpk(...) [link] 

This macro is declared in mutek/printk.h source file, line 183.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define logk(format...) [link] 

This macro is declared in mutek/printk.h source file, line 157.

This macro sends a line to the printk backends with the LOGK_LEVEL_NORMAL level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define logk(format...) [link] 

This macro is declared in mutek/printk.h source file, line 176.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define logk_debug(format...) [link] 

This macro is declared in mutek/printk.h source file, line 153.

This macro sends a line to the printk backends with the LOGK_LEVEL_DEBUG level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define logk_debug(format...) [link] 

This macro is declared in mutek/printk.h source file, line 174.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define logk_error(format...) [link] 

This macro is declared in mutek/printk.h source file, line 165.

This macro sends a line to the printk backends with the LOGK_LEVEL_ERROR level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define logk_error(format...) [link] 

This macro is declared in mutek/printk.h source file, line 180.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define logk_fatal(format...) [link] 

This macro is declared in mutek/printk.h source file, line 195.

This macro sends a line to the printk backends with the LOGK_LEVEL_ERROR level, then aborts if #CONFIG_MUTEK_PRINTK_FATAL_ABORT is set

enum logk_level_e [link] 

This enum is declared in mutek/printk.h source file, line 29.

This enum specifies the logk level.

See also logk_set_filter.

IdentifierDescription
LOGK_LEVEL_TRACE
LOGK_LEVEL_DEBUG
LOGK_LEVEL_NORMAL
LOGK_LEVEL_WARNING
LOGK_LEVEL_ERROR

void logk_set_filter(struct printk_backend_s *backend, const char id[4], enum logk_level_e level) [link] 

This function is declared in mutek/printk.h source file, line 81.

This function set the logk runtime filtering. Filtering by module is disabled if the id pointer is NULL.

This is available when CONFIG_MUTEK_PRINTK is defined.

See also CONFIG_MUTEK_PRINTK_RUNTIME_LEVEL and CONFIG_MUTEK_PRINTK_RUNTIME_EXPR.

#define logk_trace(format...) [link] 

This macro is declared in mutek/printk.h source file, line 149.

This macro sends a line to the printk backends with the LOGK_LEVEL_TRACE level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define logk_trace(format...) [link] 

This macro is declared in mutek/printk.h source file, line 172.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define logk_warning(format...) [link] 

This macro is declared in mutek/printk.h source file, line 161.

This macro sends a line to the printk backends with the LOGK_LEVEL_WARNING level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define logk_warning(format...) [link] 

This macro is declared in mutek/printk.h source file, line 178.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

ssize_t printk(const char *format, ...) [link] 

This function is declared in mutek/printk.h source file, line 91.

This function outputs a formatted string to the backends.

Output is not filtered according to the log level. Use the logk family of functions instead when the intent is to output filtered log entries.

This is available when CONFIG_MUTEK_PRINTK is defined.

See also formatter_printf.

#define printk(...) [link] 

This macro is declared in mutek/printk.h source file, line 181.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

typedef void * printk_backend_entry_t [link] 

This typedef is declared in mutek/printk.h source file, line 58.

typedef struct printk_backend_s * printk_backend_item_t [link] 

This typedef is declared in mutek/printk.h source file, line 58.

typedef void * printk_backend_root_t [link] 

This typedef is declared in mutek/printk.h source file, line 58.

struct printk_backend_s [link] 

This struct is declared in mutek/printk.h source file, line 51.

printk backend entry

See also printk_backend_item_t.

void printk_fatal_abort(void ) [link] 

This function is declared in mutek/printk.h source file, line 62.

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK_FATAL_ABORT )

#define printk_fatal_abort() [link] 

This macro is declared in mutek/printk.h source file, line 63.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK_FATAL_ABORT )

typedef void (printk_handler_t)(struct printk_backend_s *backend, const char *str, size_t len) [link] 

This typedef is declared in mutek/printk.h source file, line 47.

This typedef is the printk backend output handler. It may be called from interrupt context.

This declaration involves expansion of the PRINTK_HANDLER macro.

typedef char printk_module_len_isnt_4_t[-(sizeof("none")!=5)] [link] 

This typedef is declared in mutek/printk.h source file, line 38.

static assert for logk module id len

This declaration involves expansion of the LOGK_MODULE_ID macro.

void printk_register(struct printk_backend_s *s, printk_handler_t *handler) [link] 

This function is declared in mutek/printk.h source file, line 69.

This function registers a printk backend

This is available when CONFIG_MUTEK_PRINTK is defined.

void printk_unregister(struct printk_backend_s *s) [link] 

This function is declared in mutek/printk.h source file, line 73.

This function unregisters a printk backend

This is available when CONFIG_MUTEK_PRINTK is defined.

#define vlogk(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 156.

This macro sends a line to the printk backends with the LOGK_LEVEL_NORMAL level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define vlogk(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 175.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define vlogk_debug(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 152.

This macro sends a line to the printk backends with the LOGK_LEVEL_DEBUG level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define vlogk_debug(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 173.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define vlogk_error(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 164.

This macro sends a line to the printk backends with the LOGK_LEVEL_ERROR level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define vlogk_error(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 179.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define vlogk_fatal(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 191.

This macro sends a line to the printk backends with the LOGK_LEVEL_ERROR level, then aborts if #CONFIG_MUTEK_PRINTK_FATAL_ABORT is set

#define vlogk_trace(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 148.

This macro sends a line to the printk backends with the LOGK_LEVEL_TRACE level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define vlogk_trace(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 171.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define vlogk_warning(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 160.

This macro sends a line to the printk backends with the LOGK_LEVEL_WARNING level

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK )

#define vlogk_warning(format, ap) [link] 

This macro is declared in mutek/printk.h source file, line 177.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

ssize_t vprintk(const char *format, va_list ap) [link] 

This function is declared in mutek/printk.h source file, line 95.

This is available when CONFIG_MUTEK_PRINTK is defined.

See also printk.

#define vprintk(...) [link] 

This macro is declared in mutek/printk.h source file, line 182.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

void writek(const char *data, size_t len) [link] 

This function is declared in mutek/printk.h source file, line 112.

This function write raw data to the current backends. Output is not filtered according to the log level.

This is available when CONFIG_MUTEK_PRINTK is defined.

#define writek(...) [link] 

This macro is declared in mutek/printk.h source file, line 184.

silently ignore calls to these functions when printk is disabled.

Preprocessor condition: not defined( CONFIG_MUTEK_PRINTK )

#define LOGK_COLOR(x) [link] 

This macro is declared in mutek/printk.h source file, line 123.

This macro is for internal use only.

Preprocessor condition: defined( CONFIG_MUTEK_PRINTK_COLOR )

ssize_t logk_(const char *format, ...) [link] 

This function is declared in mutek/printk.h source file, line 120.

This is available when CONFIG_MUTEK_PRINTK is defined.

This function is for internal use only.

See also logk.

#define logk_level_(log_func, level_str, format, ...) [link] 

This macro is declared in mutek/printk.h source file, line 129.

This macro is for internal use only.

ssize_t vlogk_(const char *format, va_list ap) [link] 

This function is declared in mutek/printk.h source file, line 116.

This is available when CONFIG_MUTEK_PRINTK is defined.

This function is for internal use only.

See also vlogk.

Valid XHTML 1.0 StrictGenerated by diaxen on Thu Aug 4 15:44:06 2022 using MkDoc