libosmocore 1.13.1.1-afb4 Osmocom core library

Macros | Functions | Variables
logging.c File Reference
Osmocom logging framework

Debugging/Logging support code. More...

`#include "config.h"`
`#include <stdarg.h>`
`#include <stdlib.h>`
`#include <stdio.h>`
`#include <string.h>`
`#include <unistd.h>`
`#include <time.h>`
`#include <sys/time.h>`
`#include <sys/types.h>`
`#include <sys/stat.h>`
`#include <fcntl.h>`
`#include <errno.h>`
`#include <pthread.h>`
`#include <osmocom/core/talloc.h>`
`#include <osmocom/core/utils.h>`
`#include <osmocom/core/logging_internal.h>`
`#include <osmocom/core/timer.h>`
`#include <osmocom/core/thread.h>`
`#include <osmocom/core/select.h>`
`#include <osmocom/core/write_queue.h>`
`#include <osmocom/core/gsmtap_util.h>`
`#include <osmocom/vty/logging.h>`

## Macros
#define | TRACE(probe)
#define | TRACE_ENABLED(probe) (0)
#define | INT2IDX(x) (-1*(x)-1)

## Functions
| osmo_static_assert (_LOG_CTX_COUNT<=ARRAY_SIZE(((struct log_context *) NULL) ->ctx), enum_logging_ctx_items_fit_in_struct_log_context)
| osmo_static_assert (_LOG_FLT_COUNT<=ARRAY_SIZE(((struct log_target *) NULL) ->filter_data), enum_logging_filters_fit_in_log_target_filter_data)
| osmo_static_assert (_LOG_FLT_COUNT<=8 *sizeof(((struct log_target *) NULL) ->filter_map), enum_logging_filters_fit_in_log_target_filter_map)
| LLIST_HEAD (osmo_log_target_list)
static void | log_cache_update_all (void)
| Updates cache for all targets for all categies, caller must hold osmo_log_tgt_mutex. More...
void | log_cache_update (int mapped_subsys, uint8_t enabled, uint8_t level)
| Updates single cache entry, caller must hold osmo_log_tgt_mutex. More...
static bool | log_cache_check (int mapped_subsys, int level)
| Queries log level cache. More...
void | log_enable_multithread (void)
| Enable multithread support (mutex) in libosmocore logging system. More...
void | log_tgt_mutex_lock_impl (void)
| Acquire the osmo_log_tgt_mutex. More...
void | log_tgt_mutex_unlock_impl (void)
| Release the osmo_log_tgt_mutex. More...
void | assert_loginfo (const char *src)
static int | subsys_lib2index (int subsys)
int | log_parse_level (const char *lvl)
| Parse a human-readable log level into a numeric value. More...
const char * | log_level_str (unsigned int lvl)
| convert a numeric log level into human-readable string More...
int | log_parse_category (const char *category)
| parse a human-readable log category into numeric form More...
void | log_parse_category_mask (struct log_target *target, const char *_mask)
| parse the log category mask More...
static const char * | color (int subsys)
static const char * | level_color (int level)
const char * | log_category_name (int subsys)
static const char * | const_basename (const char *path)
int | log_output_buf (char *buf, int buf_len, struct log_target *target, unsigned int subsys, unsigned int level, const char *file, int line, int cont, const char *format, va_list ap)
| main output formatting function for log lines. More...
static int | map_subsys (int subsys)
static bool | should_log_to_target (struct log_target *tar, int subsys, int level)
void | osmo_vlogp (int subsys, int level, const char *file, int line, int cont, const char *format, va_list ap)
| vararg version of logging function More...
void | logp (int subsys, const char *file, int line, int cont, const char *format,...)
| logging function used by DEBUGP() macro More...
void | logp2 (int subsys, unsigned int level, const char *file, int line, int cont, const char *format,...)
| logging function used by LOGP() macro More...
void void | logp_stub (const char *file, int line, int cont, const char *format,...)
void | log_add_target (struct log_target *target)
| Register a new log target with the logging core. More...
void | log_del_target (struct log_target *target)
| Unregister a log target from the logging core. More...
void | log_reset_context (void)
| Reset (clear) the logging context. More...
int | log_set_context (uint8_t ctx_nr, void *value)
| Set the logging context. More...
void * | log_get_context (const struct log_context *ctx, uint8_t ctx_nr)
| Get the logging context. More...
bool | log_get_filter (const struct log_target *target, int log_filter_index)
| Query whether a log filter is enabled or disabled. More...
void | log_set_all_filter (struct log_target *target, int all)
| Enable/disable the LOG_FLT_ALL log filter. More...
int | log_set_filter (struct log_target *target, int log_filter_index, bool enable)
| Enable/disable a log filter. More...
void * | log_get_filter_data (const struct log_target *target, int log_filter_index)
| Obtain data associated to a log filter. More...
int | log_set_filter_data (struct log_target *target, int log_filter_index, void *data)
| Set data associated to a log filter. More...
void | log_set_use_color (struct log_target *target, int use_color)
| Enable or disable the use of colored output. More...
void | log_set_print_timestamp (struct log_target *target, int print_timestamp)
| Enable or disable printing of timestamps while logging. More...
void | log_set_print_extended_timestamp (struct log_target *target, int print_timestamp)
| Enable or disable printing of extended timestamps while logging. More...
void | log_set_print_tid (struct log_target *target, int print_tid)
| Enable or disable printing of timestamps while logging. More...
void | log_set_print_filename (struct log_target *target, int print_filename)
| Use log_set_print_filename2() instead. More...
void | log_set_print_filename2 (struct log_target *target, enum log_filename_type lft)
| Enable or disable printing of the filename while logging. More...
void | log_set_print_filename_pos (struct log_target *target, enum log_filename_pos pos)
| Set the position where on a log line the source file info should be logged. More...
void | log_set_print_category (struct log_target *target, int print_category)
| Enable or disable printing of the category name. More...
void | log_set_print_category_hex (struct log_target *target, int print_category_hex)
| Enable or disable printing of the category number in hex ('<000b>'). More...
void | log_set_print_level (struct log_target *target, int print_level)
| Enable or disable printing of the log level name. More...
void | log_set_log_level (struct log_target *target, int log_level)
| Set the global log level for a given log target. More...
void | log_set_category_filter (struct log_target *target, int category, int enable, int level)
| Set a category filter on a given log target. More...
struct log_target * | log_target_create (void)
| Create a new log target skeleton. More...
struct log_target * | log_target_find (enum log_target_type type, const char *fname)
| Find a registered log target. More...
void | log_target_destroy (struct log_target *target)
| Unregister, close and delete a log target. More...
int | log_targets_reopen (void)
| close and re-open all log files (for log file rotation) More...
int | log_cache_enable (void)
| Enable the log level lookup cache to bypass string formatting and other code for log statements which are not actually enabled/needed by any existing log target. More...
int | log_init (const struct log_info *inf, void *ctx)
| Initialize the Osmocom logging core. More...
void | log_fini (void)
int | log_check_level (int subsys, unsigned int level)
| Check whether a log entry will be generated. More...

## Variables
struct log_info * | osmo_log_info
static struct log_context | log_context
void * | tall_log_ctx = NULL
__thread struct log_thread_state | log_thread_state
static volatile uint8_t * | log_level_lookup_cache
| One global copy that contains the union of log levels for all targets for all categories, used for quick lock free checks of log targets. More...
static pthread_mutex_t | osmo_log_tgt_mutex
| This mutex must be held while using osmo_log_target_list or any of its log_targets in a multithread program. More...
static bool | osmo_log_tgt_mutex_on = false
const struct value_string | loglevel_strs []
static const struct log_info_cat | internal_cat [OSMO_NUM_DLIB]
static const struct value_string | level_colors []

## Detailed Description

Debugging/Logging support code.