simple.h 1.28 KB
Newer Older
1 2 3 4 5 6 7 8 9 10
/*
 * 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.
 *
 */

11 12
#ifndef TRACE_SIMPLE_H
#define TRACE_SIMPLE_H
13

14
void st_print_trace_file_status(FILE *stream, fprintf_function stream_printf);
15
void st_set_trace_file_enabled(bool enable);
16 17
void st_set_trace_file(const char *file);
bool st_init(void);
18
void st_flush_trace_buffer(void);
19

20 21 22 23 24 25 26 27 28 29 30 31
typedef struct {
    unsigned int tbuf_idx;
    unsigned int rec_off;
} TraceBufferRecord;

/* Note for hackers: Make sure MAX_TRACE_LEN < sizeof(uint32_t) */
#define MAX_TRACE_STRLEN 512
/**
 * Initialize a trace record and claim space for it in the buffer
 *
 * @arglen  number of bytes required for arguments
 */
32
int trace_record_start(TraceBufferRecord *rec, uint32_t id, size_t arglen);
33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50

/**
 * Append a 64-bit argument to a trace record
 */
void trace_record_write_u64(TraceBufferRecord *rec, uint64_t val);

/**
 * Append a string argument to a trace record
 */
void trace_record_write_str(TraceBufferRecord *rec, const char *s, uint32_t slen);

/**
 * Mark a trace record completed
 *
 * Don't append any more arguments to the trace record after calling this.
 */
void trace_record_finish(TraceBufferRecord *rec);

51
#endif /* TRACE_SIMPLE_H */