2 * Copyright (C) 2011 - Julien Desfossez <julien.desfossez@polymtl.ca>
3 * Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
4 * David Goulet <david.goulet@polymtl.ca>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License, version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #ifndef _LTTNG_KERNEL_H
21 #define _LTTNG_KERNEL_H
25 #define LTTNG_KERNEL_SYM_NAME_LEN 256
28 * LTTng DebugFS ABI structures.
30 * This is the kernel ABI copied from lttng-modules tree.
33 enum lttng_kernel_instrumentation
{
34 LTTNG_KERNEL_ALL
= -1, /* Used within lttng-tools */
35 LTTNG_KERNEL_TRACEPOINT
= 0,
36 LTTNG_KERNEL_KPROBE
= 1,
37 LTTNG_KERNEL_FUNCTION
= 2,
38 LTTNG_KERNEL_KRETPROBE
= 3,
39 LTTNG_KERNEL_NOOP
= 4, /* not hooked */
40 LTTNG_KERNEL_SYSCALL
= 5,
43 enum lttng_kernel_context_type
{
44 LTTNG_KERNEL_CONTEXT_PID
= 0,
45 LTTNG_KERNEL_CONTEXT_PERF_COUNTER
= 1,
46 LTTNG_KERNEL_CONTEXT_PROCNAME
= 2,
47 LTTNG_KERNEL_CONTEXT_PRIO
= 3,
48 LTTNG_KERNEL_CONTEXT_NICE
= 4,
49 LTTNG_KERNEL_CONTEXT_VPID
= 5,
50 LTTNG_KERNEL_CONTEXT_TID
= 6,
51 LTTNG_KERNEL_CONTEXT_VTID
= 7,
52 LTTNG_KERNEL_CONTEXT_PPID
= 8,
53 LTTNG_KERNEL_CONTEXT_VPPID
= 9,
54 LTTNG_KERNEL_CONTEXT_HOSTNAME
= 10,
57 /* Perf counter attributes */
58 struct lttng_kernel_perf_counter_ctx
{
61 char name
[LTTNG_KERNEL_SYM_NAME_LEN
];
62 }__attribute__((packed
));
64 /* Event/Channel context */
65 #define LTTNG_KERNEL_CONTEXT_PADDING1 16
66 #define LTTNG_KERNEL_CONTEXT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
67 struct lttng_kernel_context
{
68 enum lttng_kernel_context_type ctx
;
69 char padding
[LTTNG_KERNEL_CONTEXT_PADDING1
];
72 struct lttng_kernel_perf_counter_ctx perf_counter
;
73 char padding
[LTTNG_KERNEL_CONTEXT_PADDING2
];
75 }__attribute__((packed
));
77 struct lttng_kernel_kretprobe
{
81 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
82 }__attribute__((packed
));
85 * Either addr is used, or symbol_name and offset.
87 struct lttng_kernel_kprobe
{
91 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
92 }__attribute__((packed
));
95 struct lttng_kernel_function
{
96 char symbol_name
[LTTNG_KERNEL_SYM_NAME_LEN
];
97 }__attribute__((packed
));
99 #define LTTNG_KERNEL_EVENT_PADDING1 16
100 #define LTTNG_KERNEL_EVENT_PADDING2 LTTNG_KERNEL_SYM_NAME_LEN + 32
101 struct lttng_kernel_event
{
102 char name
[LTTNG_KERNEL_SYM_NAME_LEN
];
103 enum lttng_kernel_instrumentation instrumentation
;
104 char padding
[LTTNG_KERNEL_EVENT_PADDING1
];
106 /* Per instrumentation type configuration */
108 struct lttng_kernel_kretprobe kretprobe
;
109 struct lttng_kernel_kprobe kprobe
;
110 struct lttng_kernel_function ftrace
;
111 char padding
[LTTNG_KERNEL_EVENT_PADDING2
];
113 }__attribute__((packed
));
115 struct lttng_kernel_tracer_version
{
119 }__attribute__((packed
));
121 enum lttng_kernel_calibrate_type
{
122 LTTNG_KERNEL_CALIBRATE_KRETPROBE
,
125 struct lttng_kernel_calibrate
{
126 enum lttng_kernel_calibrate_type type
; /* type (input) */
127 }__attribute__((packed
));
132 #define LTTNG_KERNEL_CHANNEL_PADDING1 LTTNG_SYMBOL_NAME_LEN + 32
133 struct lttng_kernel_channel
{
134 uint64_t subbuf_size
; /* bytes */
135 uint64_t num_subbuf
; /* power of 2 */
136 unsigned int switch_timer_interval
; /* usec */
137 unsigned int read_timer_interval
; /* usec */
138 enum lttng_event_output output
; /* splice, mmap */
140 int overwrite
; /* 1: overwrite, 0: discard */
141 char padding
[LTTNG_KERNEL_CHANNEL_PADDING1
];
142 }__attribute__((packed
));
144 #endif /* _LTTNG_KERNEL_H */