7 * Copyright (C) 2005-2011 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
9 * This contains the definitions for the Linux Trace Toolkit tracer.
11 * Dual LGPL v2.1/GPL v2 license.
15 #include <linux/types.h>
16 #include <linux/limits.h>
17 #include <linux/list.h>
18 #include <linux/cache.h>
19 #include <linux/timex.h>
20 #include <linux/wait.h>
21 #include <asm/atomic.h>
22 #include <asm/local.h>
24 #include "wrapper/trace-clock.h"
25 #include "ltt-tracer-core.h"
26 #include "ltt-events.h"
28 #define LTTNG_VERSION 0
29 #define LTTNG_PATCHLEVEL 9
30 #define LTTNG_SUBLEVEL 1
36 /* Number of bytes to log with a read/write event */
37 #define LTT_LOG_RW_SIZE 32L
39 /* Maximum number of callbacks per marker */
40 #define LTT_NR_CALLBACKS 10
42 struct ltt_serialize_closure
;
44 /* Serialization callback */
45 typedef size_t (*ltt_serialize_cb
)(struct lib_ring_buffer
*buf
,
47 struct ltt_serialize_closure
*closure
,
48 void *serialize_private
,
49 unsigned int stack_pos_ctx
,
51 const char *fmt
, va_list *args
);
53 struct ltt_serialize_closure
{
54 ltt_serialize_cb
*callbacks
;
55 long cb_args
[LTT_NR_CALLBACKS
];
59 size_t ltt_serialize_data(struct lib_ring_buffer
*buf
, size_t buf_offset
,
60 struct ltt_serialize_closure
*closure
,
61 void *serialize_private
, unsigned int stack_pos_ctx
,
62 int *largest_align
, const char *fmt
, va_list *args
);
67 LTT_CHANNEL_GLOBAL_STATE
,
68 LTT_CHANNEL_IRQ_STATE
,
69 LTT_CHANNEL_MODULE_STATE
,
70 LTT_CHANNEL_NETIF_STATE
,
71 LTT_CHANNEL_SOFTIRQ_STATE
,
72 LTT_CHANNEL_SWAP_STATE
,
73 LTT_CHANNEL_SYSCALL_STATE
,
74 LTT_CHANNEL_TASK_STATE
,
86 * Hardcoded event headers
88 * event header for a trace with active heartbeat : 27 bits timestamps
90 * headers are 32-bits aligned. In order to insure such alignment, a dynamic per
91 * trace alignment value must be done.
93 * Remember that the C compiler does align each member on the boundary
94 * equivalent to their own size.
96 * As relay subbuffers are aligned on pages, we are sure that they are 4 and 8
97 * bytes aligned, so the buffer header and trace header are aligned.
99 * Event headers are aligned depending on the trace alignment option.
101 * Note using C structure bitfields for cross-endianness and portability
105 #define LTT_MAX_SMALL_SIZE 0xFFFFU
107 #ifdef RING_BUFFER_ALIGN
108 #define ltt_alignof(type) __alignof__(type)
110 #define ltt_alignof(type) 1
113 /* Tracer properties */
114 #define CTF_MAGIC_NUMBER 0xC1FC1FC1
115 #define TSDL_MAGIC_NUMBER 0x75D11D57
116 #define CTF_VERSION_MAJOR 0
117 #define CTF_VERSION_MINOR 1
120 * Number of milliseconds to retry before failing metadata writes on buffer full
121 * condition. (10 seconds)
123 #define LTTNG_METADATA_TIMEOUT_MSEC 10000
126 * Size reserved for high priority events (interrupts, NMI, BH) at the end of a
127 * nearly full buffer. User space won't use this last amount of space when in
128 * blocking mode. This space also includes the event header that would be
129 * written by this user space event.
131 #define LTT_RESERVE_CRITICAL 4096
133 #define LTT_RFLAG_EXTENDED RING_BUFFER_RFLAG_END
134 #define LTT_RFLAG_END (LTT_RFLAG_EXTENDED << 1)
136 /* Register and unregister function pointers */
138 enum ltt_module_function
{
139 LTT_FUNCTION_RUN_FILTER
,
140 LTT_FUNCTION_FILTER_CONTROL
,
141 LTT_FUNCTION_STATEDUMP
144 extern int ltt_module_register(enum ltt_module_function name
, void *function
,
145 struct module
*owner
);
146 extern void ltt_module_unregister(enum ltt_module_function name
);
148 /* Exported control function */
150 void ltt_core_register(int (*function
)(u8
, void *));
152 void ltt_core_unregister(void);
155 void ltt_statedump_register_kprobes_dump(void (*callback
)(void *call_data
));
157 void ltt_statedump_unregister_kprobes_dump(void (*callback
)(void *call_data
));
159 extern void ltt_dump_softirq_vec(void *call_data
);
161 #ifdef CONFIG_HAVE_LTT_DUMP_TABLES
162 extern void ltt_dump_sys_call_table(void *call_data
);
163 extern void ltt_dump_idt_table(void *call_data
);
165 static inline void ltt_dump_sys_call_table(void *call_data
)
169 static inline void ltt_dump_idt_table(void *call_data
)
174 #endif /* _LTT_TRACER_H */