# TRACE

NAME
INTRODUCTION
SYNOPSIS
DESCRIPTION
MESSAGE FORMATTING
REDIRECTING TRACE MESSAGES
RUNTIME CONFIGURATION
BUGS
SEE ALSO

## NAME

trace_init, trace_exit, trace_open, trace_close, trace_set_destination, trace_set_header, trace_add_component, trace_del_component, trace_write, trace_enable, trace_disable, trace_on, trace_off, trace_parse_flags, trace_list_flags, trace_reset_filters, trace_add_simple_filter, trace_del_simple_filter - produce filterable trace messages

## INTRODUCTION

## SYNOPSIS

#include <simple-trace/simple-.h>

int trace_init(void);
void trace_exit(void);
int trace_context_open(char *name);
void trace_context_close(int cid);
int trace_context_format(int cid, const char *format);
int trace_context_target(int cid, const char *target);
int trace_context_enable(int cid);
int trace_context_disable(int cid);
int trace_module_add(int cid, trace_moduledef_t *module);
int trace_module_del(int cid, const char *name);
int trace_flag_set(int fid);
int trace_flag_clr(int fid);
int trace_flag_tst(int fid);
int trace_configure(const char *config);
void __trace_printf(int id, const char *file, int line, const char *func, const char *format, ...);
#define trace_printf(int id, format, args...)

## DESCRIPTION

trace_init() is used to initialise the trace library. It must be invoked once prior to calling any other functions of the trace library. trace_exit() can be used to deinitialize the library. It frees any potential resources consumed by the library. Once the trace library is deinitialized, no other functions should be called until it is reinitialized with trace_init() again.

Typically, applications invoke trace_init() during their startup/initialization phase. Similarly they invoke trace_exit() to clean up during their shutdown/deinitialization phase, usually right before exit(3) ing.

## MESSAGE FORMATTING

## REDIRECTING TRACE MESSAGES

## RUNTIME CONFIGURATION

Low-level configuration interface

High-level configuration interface

trace_configure() parses a configuration request string to change the set of active trace flags and applies the requested changes.

## BUGS

Please, report any other bugs.

## SEE ALSO

printf(3)