9 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
11 * This library is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public
13 * License as published by the Free Software Foundation; only
14 * version 2.1 of the License.
16 * This library is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with this library; if not, write to the Free Software
23 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
28 #define LTTNG_KERNEL_SYM_NAME_LEN 256
30 enum lttng_kernel_instrumentation
{
31 LTTNG_KERNEL_TRACEPOINT
= 0,
32 LTTNG_KERNEL_KPROBE
= 1,
33 LTTNG_KERNEL_FUNCTION
= 2,
34 LTTNG_KERNEL_KRETPROBE
= 3,
35 LTTNG_KERNEL_NOOP
= 4, /* not hooked */
36 LTTNG_KERNEL_SYSCALL
= 5,
42 enum lttng_kernel_output
{
43 LTTNG_KERNEL_SPLICE
= 0,
44 LTTNG_KERNEL_MMAP
= 1,
48 * LTTng DebugFS ABI structures.
50 #define LTTNG_KERNEL_CHANNEL_PADDING LTTNG_KERNEL_SYM_NAME_LEN + 32
51 struct lttng_kernel_channel
{
52 uint64_t subbuf_size
; /* in bytes */
54 unsigned int switch_timer_interval
; /* usecs */
55 unsigned int read_timer_interval
; /* usecs */
56 enum lttng_kernel_output output
; /* splice, mmap */
57 int overwrite
; /* 1: overwrite, 0: discard */
58 char padding
[LTTNG_KERNEL_CHANNEL_PADDING
];
59 }__attribute__((packed
));
61 struct lttng_kernel_kretprobe
{
65 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
66 }__attribute__((packed
));
69 * Either addr is used, or symbol_name and offset.
71 struct lttng_kernel_kprobe
{
75 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
76 }__attribute__((packed
));
78 struct lttng_kernel_function_tracer
{
79 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
80 }__attribute__((packed
));
82 struct lttng_kernel_syscall
{
84 } __attribute__((packed
));
87 * For syscall tracing, name = '\0' means "enable all".
89 #define LTTNG_KERNEL_EVENT_PADDING1 16
90 #define LTTNG_KERNEL_EVENT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
91 struct lttng_kernel_event
{
92 char name
[LTTNG_KERNEL_SYM_NAME_LEN
]; /* event name */
93 enum lttng_kernel_instrumentation instrumentation
;
94 char padding
[LTTNG_KERNEL_EVENT_PADDING1
];
96 /* Per instrumentation type configuration */
98 struct lttng_kernel_kretprobe kretprobe
;
99 struct lttng_kernel_kprobe kprobe
;
100 struct lttng_kernel_function_tracer ftrace
;
101 struct lttng_kernel_syscall syscall
;
102 char padding
[LTTNG_KERNEL_EVENT_PADDING2
];
104 }__attribute__((packed
));
106 struct lttng_kernel_tracer_version
{
110 }__attribute__((packed
));
112 enum lttng_kernel_calibrate_type
{
113 LTTNG_KERNEL_CALIBRATE_KRETPROBE
,
116 struct lttng_kernel_calibrate
{
117 enum lttng_kernel_calibrate_type type
; /* type (input) */
118 }__attribute__((packed
));
120 enum lttng_kernel_context_type
{
121 LTTNG_KERNEL_CONTEXT_PID
= 0,
122 LTTNG_KERNEL_CONTEXT_PERF_COUNTER
= 1,
123 LTTNG_KERNEL_CONTEXT_PROCNAME
= 2,
124 LTTNG_KERNEL_CONTEXT_PRIO
= 3,
125 LTTNG_KERNEL_CONTEXT_NICE
= 4,
126 LTTNG_KERNEL_CONTEXT_VPID
= 5,
127 LTTNG_KERNEL_CONTEXT_TID
= 6,
128 LTTNG_KERNEL_CONTEXT_VTID
= 7,
129 LTTNG_KERNEL_CONTEXT_PPID
= 8,
130 LTTNG_KERNEL_CONTEXT_VPPID
= 9,
131 LTTNG_KERNEL_CONTEXT_HOSTNAME
= 10,
134 struct lttng_kernel_perf_counter_ctx
{
137 char name
[LTTNG_KERNEL_SYM_NAME_LEN
];
138 }__attribute__((packed
));
140 #define LTTNG_KERNEL_CONTEXT_PADDING1 16
141 #define LTTNG_KERNEL_CONTEXT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
142 struct lttng_kernel_context
{
143 enum lttng_kernel_context_type ctx
;
144 char padding
[LTTNG_KERNEL_CONTEXT_PADDING1
];
147 struct lttng_kernel_perf_counter_ctx perf_counter
;
148 char padding
[LTTNG_KERNEL_CONTEXT_PADDING2
];
150 }__attribute__((packed
));
152 /* LTTng file descriptor ioctl */
153 #define LTTNG_KERNEL_SESSION _IO(0xF6, 0x45)
154 #define LTTNG_KERNEL_TRACER_VERSION \
155 _IOR(0xF6, 0x46, struct lttng_kernel_tracer_version)
156 #define LTTNG_KERNEL_TRACEPOINT_LIST _IO(0xF6, 0x47)
157 #define LTTNG_KERNEL_WAIT_QUIESCENT _IO(0xF6, 0x48)
158 #define LTTNG_KERNEL_CALIBRATE \
159 _IOWR(0xF6, 0x49, struct lttng_kernel_calibrate)
160 #define LTTNG_KERNEL_SYSCALL_LIST _IO(0xF6, 0x49)
162 /* Session FD ioctl */
163 #define LTTNG_KERNEL_METADATA \
164 _IOW(0xF6, 0x54, struct lttng_kernel_channel)
165 #define LTTNG_KERNEL_CHANNEL \
166 _IOW(0xF6, 0x55, struct lttng_kernel_channel)
167 #define LTTNG_KERNEL_SESSION_START _IO(0xF6, 0x56)
168 #define LTTNG_KERNEL_SESSION_STOP _IO(0xF6, 0x57)
170 /* Channel FD ioctl */
171 #define LTTNG_KERNEL_STREAM _IO(0xF6, 0x62)
172 #define LTTNG_KERNEL_EVENT \
173 _IOW(0xF6, 0x63, struct lttng_kernel_event)
175 /* Event and Channel FD ioctl */
176 #define LTTNG_KERNEL_CONTEXT \
177 _IOW(0xF6, 0x71, struct lttng_kernel_context)
179 /* Event, Channel and Session ioctl */
180 #define LTTNG_KERNEL_ENABLE _IO(0xF6, 0x82)
181 #define LTTNG_KERNEL_DISABLE _IO(0xF6, 0x83)
183 /* LTTng-specific ioctls for the lib ringbuffer */
184 /* returns the timestamp begin of the current sub-buffer */
185 #define LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN _IOR(0xF6, 0x20, uint64_t)
186 /* returns the timestamp end of the current sub-buffer */
187 #define LTTNG_RING_BUFFER_GET_TIMESTAMP_END _IOR(0xF6, 0x21, uint64_t)
188 /* returns the number of events discarded */
189 #define LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED _IOR(0xF6, 0x22, uint64_t)
190 /* returns the packet payload size */
191 #define LTTNG_RING_BUFFER_GET_CONTENT_SIZE _IOR(0xF6, 0x23, uint64_t)
192 /* returns the actual packet size */
193 #define LTTNG_RING_BUFFER_GET_PACKET_SIZE _IOR(0xF6, 0x24, uint64_t)
194 /* returns the stream id */
195 #define LTTNG_RING_BUFFER_GET_STREAM_ID _IOR(0xF6, 0x25, uint64_t)
196 /* returns the current timestamp */
197 #define LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP _IOR(0xF6, 0x26, uint64_t)
200 /* returns the timestamp begin of the current sub-buffer */
201 #define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_BEGIN \
202 LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN
203 /* returns the timestamp end of the current sub-buffer */
204 #define LTTNG_RING_BUFFER_COMPAT_GET_TIMESTAMP_END \
205 LTTNG_RING_BUFFER_GET_TIMESTAMP_END
206 /* returns the number of events discarded */
207 #define LTTNG_RING_BUFFER_COMPAT_GET_EVENTS_DISCARDED \
208 LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED
209 /* returns the packet payload size */
210 #define LTTNG_RING_BUFFER_COMPAT_GET_CONTENT_SIZE \
211 LTTNG_RING_BUFFER_GET_CONTENT_SIZE
212 /* returns the actual packet size */
213 #define LTTNG_RING_BUFFER_COMPAT_GET_PACKET_SIZE \
214 LTTNG_RING_BUFFER_GET_PACKET_SIZE
215 /* returns the stream id */
216 #define LTTNG_RING_BUFFER_COMPAT_GET_STREAM_ID \
217 LTTNG_RING_BUFFER_GET_STREAM_ID
218 /* returns the current timestamp */
219 #define LTTNG_RING_BUFFER_COMPAT_GET_CURRENT_TIMESTAMP \
220 LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP
221 #endif /* CONFIG_COMPAT */
223 #endif /* _LTTNG_ABI_H */