Commit | Line | Data |
---|---|---|
826d496d | 1 | /* |
b7384347 DG |
2 | * lttng.h |
3 | * | |
4 | * Linux Trace Toolkit Control Library Header File | |
5 | * | |
826d496d | 6 | * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca> |
fac6795d DG |
7 | * |
8 | * This program is free software; you can redistribute it and/or | |
9 | * modify it under the terms of the GNU General Public License | |
10 | * as published by the Free Software Foundation; either version 2 | |
11 | * of the License, or (at your option) any later version. | |
12 | * | |
13 | * This program is distributed in the hope that it will be useful, | |
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | * GNU General Public License for more details. | |
17 | * | |
18 | * You should have received a copy of the GNU General Public License | |
19 | * along with this program; if not, write to the Free Software | |
20 | * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. | |
fac6795d DG |
21 | */ |
22 | ||
b7384347 DG |
23 | #ifndef _LTTNG_H |
24 | #define _LTTNG_H | |
fac6795d | 25 | |
f3ed775e DG |
26 | #include <asm/types.h> |
27 | #include <stdint.h> | |
57167058 DG |
28 | #include <limits.h> |
29 | ||
b7384347 DG |
30 | /* Default unix group name for tracing. */ |
31 | #define LTTNG_DEFAULT_TRACING_GROUP "tracing" | |
fac6795d | 32 | |
b7384347 | 33 | /* Environment variable to set session daemon binary path. */ |
5b8719f5 DG |
34 | #define LTTNG_SESSIOND_PATH_ENV "LTTNG_SESSIOND_PATH" |
35 | ||
b7384347 | 36 | /* |
f3ed775e | 37 | * Event symbol length. |
1657e9bb | 38 | */ |
f3ed775e DG |
39 | #define LTTNG_SYMBOL_NAME_LEN 128 |
40 | ||
41 | enum lttng_event_type { | |
42 | LTTNG_EVENT_TRACEPOINTS, | |
43 | LTTNG_EVENT_KPROBES, | |
44 | LTTNG_EVENT_FUNCTION, | |
1657e9bb DG |
45 | }; |
46 | ||
d65106b1 DG |
47 | /* Kernel context possible type */ |
48 | enum lttng_kernel_context_type { | |
49 | LTTNG_KERNEL_CONTEXT_PID = 0, | |
50 | LTTNG_KERNEL_CONTEXT_PERF_COUNTER = 1, | |
51 | LTTNG_KERNEL_CONTEXT_COMM = 2, | |
52 | LTTNG_KERNEL_CONTEXT_PRIO = 3, | |
53 | LTTNG_KERNEL_CONTEXT_NICE = 4, | |
54 | LTTNG_KERNEL_CONTEXT_VPID = 5, | |
55 | LTTNG_KERNEL_CONTEXT_TID = 6, | |
56 | LTTNG_KERNEL_CONTEXT_VTID = 7, | |
57 | LTTNG_KERNEL_CONTEXT_PPID = 8, | |
58 | LTTNG_KERNEL_CONTEXT_VPPID = 9, | |
59 | }; | |
60 | ||
61 | /* Perf counter attributes */ | |
62 | struct lttng_kernel_perf_counter_ctx { | |
63 | uint32_t type; | |
64 | uint64_t config; | |
65 | char name[LTTNG_SYMBOL_NAME_LEN]; | |
66 | }; | |
67 | ||
68 | /* Event/Channel context */ | |
69 | struct lttng_kernel_context { | |
70 | enum lttng_kernel_context_type ctx; | |
71 | union { | |
72 | struct lttng_kernel_perf_counter_ctx perf_counter; | |
73 | } u; | |
74 | }; | |
75 | ||
b7384347 | 76 | /* |
f3ed775e | 77 | * Either addr is used or symbol_name and offset. |
57167058 | 78 | */ |
f3ed775e DG |
79 | struct lttng_event_kprobe_attr { |
80 | uint64_t addr; | |
81 | ||
82 | uint64_t offset; | |
83 | char symbol_name[LTTNG_SYMBOL_NAME_LEN]; | |
57167058 DG |
84 | }; |
85 | ||
b7384347 | 86 | /* |
f3ed775e DG |
87 | * Function tracer |
88 | */ | |
89 | struct lttng_event_function_attr { | |
90 | char symbol_name[LTTNG_SYMBOL_NAME_LEN]; | |
91 | }; | |
92 | ||
93 | /* | |
94 | * Generic lttng event | |
95 | */ | |
96 | struct lttng_event { | |
97 | char name[LTTNG_SYMBOL_NAME_LEN]; | |
98 | enum lttng_event_type type; | |
99 | /* Per event type configuration */ | |
100 | union { | |
101 | struct lttng_event_kprobe_attr kprobe; | |
102 | struct lttng_event_function_attr ftrace; | |
103 | } attr; | |
104 | }; | |
105 | ||
106 | /* Tracer channel attributes */ | |
107 | struct lttng_channel_attr { | |
108 | int overwrite; /* 1: overwrite, 0: discard */ | |
109 | uint64_t subbuf_size; /* bytes */ | |
110 | uint64_t num_subbuf; /* power of 2 */ | |
111 | unsigned int switch_timer_interval; /* usec */ | |
112 | unsigned int read_timer_interval; /* usec */ | |
113 | }; | |
114 | ||
115 | /* | |
116 | * Basic session information. | |
1657e9bb | 117 | */ |
b7384347 | 118 | struct lttng_session { |
1657e9bb | 119 | char name[NAME_MAX]; |
f3ed775e DG |
120 | char path[PATH_MAX]; |
121 | }; | |
122 | ||
123 | /* Channel information structure */ | |
124 | struct lttng_channel { | |
125 | char name[NAME_MAX]; | |
126 | struct lttng_channel_attr attr; | |
1657e9bb DG |
127 | }; |
128 | ||
b7384347 DG |
129 | /* |
130 | * Session daemon control | |
131 | */ | |
b7384347 | 132 | extern int lttng_connect_sessiond(void); |
f3ed775e DG |
133 | |
134 | extern int lttng_create_session(char *name, char *path); | |
135 | ||
136 | extern int lttng_destroy_session(char *name); | |
137 | ||
87378cf5 | 138 | extern int lttng_disconnect_sessiond(void); |
f3ed775e | 139 | |
b7384347 | 140 | /* Return an allocated array of lttng_session */ |
ca95a216 | 141 | extern int lttng_list_sessions(struct lttng_session **sessions); |
f3ed775e | 142 | |
947308c4 | 143 | extern int lttng_session_daemon_alive(void); |
f3ed775e | 144 | |
b7384347 DG |
145 | /* Set tracing group for the current execution */ |
146 | extern int lttng_set_tracing_group(const char *name); | |
f3ed775e DG |
147 | |
148 | extern void lttng_set_session_name(char *name); | |
149 | ||
b7384347 DG |
150 | extern const char *lttng_get_readable_code(int code); |
151 | ||
f3ed775e DG |
152 | extern int lttng_start_tracing(char *session_name); |
153 | ||
154 | extern int lttng_stop_tracing(char *session_name); | |
155 | ||
156 | //extern int lttng_ust_list_traceable_apps(pid_t **pids); | |
157 | ||
b7384347 | 158 | /* |
f3ed775e | 159 | * LTTng Kernel tracer control |
b7384347 | 160 | */ |
d65106b1 DG |
161 | extern int lttng_kernel_add_context(struct lttng_kernel_context *ctx, |
162 | char *event_name, char *channel_name); | |
163 | ||
f3ed775e DG |
164 | extern int lttng_kernel_create_channel(struct lttng_channel *chan); |
165 | ||
166 | extern int lttng_kernel_enable_event(struct lttng_event *ev, char *channel_name); | |
167 | ||
168 | extern int lttng_kernel_enable_channel(char *name); | |
169 | ||
170 | extern int lttng_kernel_disable_event(char *name, char *channel_name); | |
171 | ||
172 | extern int lttng_kernel_disable_channel(char *name); | |
173 | ||
174 | extern int lttng_kernel_list_events(char **event_list); | |
fac6795d | 175 | |
1df4dedd | 176 | /* |
f3ed775e | 177 | * LTTng User-space tracer control |
1df4dedd | 178 | */ |
1df4dedd | 179 | |
b7384347 | 180 | #endif /* _LTTNG_H */ |