0b5538c300
Trace events outside the global mutex cannot be used with the simple trace backend since it is not thread-safe. There is no check to prevent them being enabled so people sometimes learn this the hard way. This patch restructures the simple trace backend with a ring buffer suitable for multiple concurrent writers. A writeout thread empties the trace buffer when threshold fill levels are reached. Should the writeout thread be unable to keep up with trace generation, records will simply be dropped. Each time events are dropped a special record is written to the trace file indicating how many events were dropped. The event ID is 0xfffffffffffffffe and its signature is dropped(uint32_t count). Signed-off-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
49 lines
1.5 KiB
C
49 lines
1.5 KiB
C
/*
|
|
* Simple trace backend
|
|
*
|
|
* Copyright IBM, Corp. 2010
|
|
*
|
|
* This work is licensed under the terms of the GNU GPL, version 2. See
|
|
* the COPYING file in the top-level directory.
|
|
*
|
|
*/
|
|
|
|
#ifndef SIMPLETRACE_H
|
|
#define SIMPLETRACE_H
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <stdio.h>
|
|
|
|
#ifdef CONFIG_SIMPLE_TRACE
|
|
typedef uint64_t TraceEventID;
|
|
|
|
typedef struct {
|
|
const char *tp_name;
|
|
bool state;
|
|
} TraceEvent;
|
|
|
|
void trace0(TraceEventID event);
|
|
void trace1(TraceEventID event, uint64_t x1);
|
|
void trace2(TraceEventID event, uint64_t x1, uint64_t x2);
|
|
void trace3(TraceEventID event, uint64_t x1, uint64_t x2, uint64_t x3);
|
|
void trace4(TraceEventID event, uint64_t x1, uint64_t x2, uint64_t x3, uint64_t x4);
|
|
void trace5(TraceEventID event, uint64_t x1, uint64_t x2, uint64_t x3, uint64_t x4, uint64_t x5);
|
|
void trace6(TraceEventID event, uint64_t x1, uint64_t x2, uint64_t x3, uint64_t x4, uint64_t x5, uint64_t x6);
|
|
void st_print_trace(FILE *stream, fprintf_function stream_printf);
|
|
void st_print_trace_events(FILE *stream, fprintf_function stream_printf);
|
|
bool st_change_trace_event_state(const char *tname, bool tstate);
|
|
void st_print_trace_file_status(FILE *stream, fprintf_function stream_printf);
|
|
void st_set_trace_file_enabled(bool enable);
|
|
bool st_set_trace_file(const char *file);
|
|
void st_flush_trace_buffer(void);
|
|
void st_init(const char *file);
|
|
#else
|
|
static inline void st_init(const char *file)
|
|
{
|
|
/* Do nothing */
|
|
}
|
|
#endif /* !CONFIG_SIMPLE_TRACE */
|
|
|
|
#endif /* SIMPLETRACE_H */
|