Add enable kernel channel support
[lttng-tools.git] / liblttngctl / liblttngctl.c
... / ...
CommitLineData
1/*
2 * Copyright (C) 2011 David Goulet <david.goulet@polymtl.ca>
3 *
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version 2
7 * of the License, or (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17 */
18
19#define _GNU_SOURCE
20#include <errno.h>
21#include <grp.h>
22#include <stdio.h>
23#include <stdlib.h>
24#include <string.h>
25#include <unistd.h>
26
27#include <lttng/lttng.h>
28
29#include "liblttsessiondcomm.h"
30#include "lttngerr.h"
31#include "lttng-share.h"
32
33/* Socket to session daemon for communication */
34static int sessiond_socket;
35static char sessiond_sock_path[PATH_MAX];
36
37/* Communication structure to ltt-sessiond */
38static struct lttcomm_session_msg lsm;
39static struct lttcomm_lttng_msg llm;
40
41/* Variables */
42static char *tracing_group;
43static int connected;
44
45/*
46 * send_data_sessiond
47 *
48 * Send lttcomm_session_msg to the session daemon.
49 *
50 * On success, return 0
51 * On error, return error code
52 */
53static int send_data_sessiond(void)
54{
55 int ret;
56
57 if (!connected) {
58 ret = -ENOTCONN;
59 goto end;
60 }
61
62 ret = lttcomm_send_unix_sock(sessiond_socket, &lsm, sizeof(lsm));
63
64end:
65 return ret;
66}
67
68/*
69 * recv_data_sessiond
70 *
71 * Receive data from the sessiond socket.
72 *
73 * On success, return 0
74 * On error, return recv() error code
75 */
76static int recv_data_sessiond(void *buf, size_t len)
77{
78 int ret;
79
80 if (!connected) {
81 ret = -ENOTCONN;
82 goto end;
83 }
84
85 ret = lttcomm_recv_unix_sock(sessiond_socket, buf, len);
86
87end:
88 return ret;
89}
90
91/*
92 * ask_sessiond
93 *
94 * Ask the session daemon a specific command and put the data into buf.
95 *
96 * Return size of data (only payload, not header).
97 */
98static int ask_sessiond(enum lttcomm_sessiond_command lct, void **buf)
99{
100 int ret;
101 size_t size;
102 void *data = NULL;
103
104 ret = lttng_connect_sessiond();
105 if (ret < 0) {
106 goto end;
107 }
108
109 lsm.cmd_type = lct;
110
111 /* Send command to session daemon */
112 ret = send_data_sessiond();
113 if (ret < 0) {
114 goto end;
115 }
116
117 /* Get header from data transmission */
118 ret = recv_data_sessiond(&llm, sizeof(llm));
119 if (ret < 0) {
120 goto end;
121 }
122
123 /* Check error code if OK */
124 if (llm.ret_code != LTTCOMM_OK) {
125 ret = -llm.ret_code;
126 goto end;
127 }
128
129 size = llm.data_size;
130 if (size == 0) {
131 goto end;
132 }
133
134 data = (void*) malloc(size);
135
136 /* Get payload data */
137 ret = recv_data_sessiond(data, size);
138 if (ret < 0) {
139 free(data);
140 goto end;
141 }
142
143 *buf = data;
144 ret = size;
145
146end:
147 lttng_disconnect_sessiond();
148 return ret;
149}
150
151/*
152 * check_tracing_group
153 *
154 * Check if the specified group name exist.
155 * If yes, 0, else -1
156 */
157static int check_tracing_group(const char *grp_name)
158{
159 struct group *grp_tracing; /* no free(). See getgrnam(3) */
160 gid_t *grp_list;
161 int grp_list_size, grp_id, i;
162 int ret = -1;
163
164 /* Get GID of group 'tracing' */
165 grp_tracing = getgrnam(grp_name);
166 if (grp_tracing == NULL) {
167 /* NULL means not found also. getgrnam(3) */
168 if (errno != 0) {
169 perror("getgrnam");
170 }
171 goto end;
172 }
173
174 /* Get number of supplementary group IDs */
175 grp_list_size = getgroups(0, NULL);
176 if (grp_list_size < 0) {
177 perror("getgroups");
178 goto end;
179 }
180
181 /* Alloc group list of the right size */
182 grp_list = malloc(grp_list_size * sizeof(gid_t));
183 grp_id = getgroups(grp_list_size, grp_list);
184 if (grp_id < -1) {
185 perror("getgroups");
186 goto free_list;
187 }
188
189 for (i = 0; i < grp_list_size; i++) {
190 if (grp_list[i] == grp_tracing->gr_gid) {
191 ret = 0;
192 break;
193 }
194 }
195
196free_list:
197 free(grp_list);
198
199end:
200 return ret;
201}
202
203/*
204 * set_session_daemon_path
205 *
206 * Set sessiond socket path by putting it in
207 * the global sessiond_sock_path variable.
208 */
209static int set_session_daemon_path(void)
210{
211 int ret;
212
213 /* Are we in the tracing group ? */
214 ret = check_tracing_group(tracing_group);
215 if (ret < 0 && getuid() != 0) {
216 if (sprintf(sessiond_sock_path, DEFAULT_HOME_CLIENT_UNIX_SOCK,
217 getenv("HOME")) < 0) {
218 return -ENOMEM;
219 }
220 } else {
221 strncpy(sessiond_sock_path, DEFAULT_GLOBAL_CLIENT_UNIX_SOCK,
222 sizeof(DEFAULT_GLOBAL_CLIENT_UNIX_SOCK));
223 }
224
225 return 0;
226}
227
228/*
229 * lttng_start_tracing
230 *
231 * Start tracing for all trace of the session.
232 */
233int lttng_start_tracing(char *session_name)
234{
235 strncpy(lsm.session_name, session_name, NAME_MAX);
236 return ask_sessiond(LTTNG_START_TRACE, NULL);
237}
238
239/*
240 * lttng_stop_tracing
241 *
242 * Stop tracing for all trace of the session.
243 */
244int lttng_stop_tracing(char *session_name)
245{
246 strncpy(lsm.session_name, session_name, NAME_MAX);
247 return ask_sessiond(LTTNG_STOP_TRACE, NULL);
248}
249
250/*
251 * BEGIN Kernel control API
252 */
253
254/*
255 * lttng_kernel_enable_event
256 */
257int lttng_kernel_enable_event(struct lttng_event *ev, char *channel_name)
258{
259 int ret;
260
261 if (strlen(channel_name) == 0) {
262 strncpy(lsm.u.enable.channel_name, DEFAULT_CHANNEL_NAME, NAME_MAX);
263 } else {
264 strncpy(lsm.u.enable.channel_name, channel_name, NAME_MAX);
265 }
266
267 if (ev == NULL) {
268 ret = ask_sessiond(LTTNG_KERNEL_ENABLE_ALL_EVENT, NULL);
269 } else {
270 memcpy(&lsm.u.enable.event, ev, sizeof(struct lttng_event));
271 ret = ask_sessiond(LTTNG_KERNEL_ENABLE_EVENT, NULL);
272 }
273
274 return ret;
275}
276
277/*
278 * lttng_kernel_disable_event
279 *
280 * Disable an event in the kernel tracer.
281 */
282int lttng_kernel_disable_event(char *name, char *channel_name)
283{
284 int ret;
285
286 if (strlen(channel_name) == 0) {
287 strncpy(lsm.u.disable.channel_name, DEFAULT_CHANNEL_NAME, NAME_MAX);
288 } else {
289 strncpy(lsm.u.disable.channel_name, channel_name, NAME_MAX);
290 }
291
292 if (name == NULL) {
293 ret = ask_sessiond(LTTNG_KERNEL_DISABLE_ALL_EVENT, NULL);
294 } else {
295 strncpy(lsm.u.disable.name, name, NAME_MAX);
296 ret = ask_sessiond(LTTNG_KERNEL_DISABLE_EVENT, NULL);
297 }
298
299 return ret;
300}
301
302/*
303 * lttng_kernel_enable_channel
304 *
305 * Enable recording for a channel for the kernel tracer.
306 */
307int lttng_kernel_enable_channel(char *name)
308{
309 strncpy(lsm.u.enable.channel_name, name, NAME_MAX);
310 return ask_sessiond(LTTNG_KERNEL_ENABLE_CHANNEL, NULL);
311}
312
313/*
314 * lttng_kernel_disable_channel
315 *
316 * Disable recording for the channel for the kernel tracer.
317 */
318int lttng_kernel_disable_channel(char *name)
319{
320 return ask_sessiond(LTTNG_KERNEL_DISABLE_CHANNEL, NULL);
321}
322
323/*
324 * lttng_kernel_create_channel
325 *
326 * Create a channel in the kernel tracer.
327 */
328int lttng_kernel_create_channel(struct lttng_channel *chan)
329{
330 memcpy(&lsm.u.channel.chan, chan, sizeof(struct lttng_channel));
331 return ask_sessiond(LTTNG_KERNEL_CREATE_CHANNEL, NULL);
332}
333
334/*
335 * lttng_list_events
336 *
337 * List all available events in the kernel.
338 *
339 * Return the size (bytes) of the list and set the event_list array.
340 * On error, return negative value.
341 */
342int lttng_kernel_list_events(char **event_list)
343{
344 return ask_sessiond(LTTNG_KERNEL_LIST_EVENTS, (void **) event_list);
345}
346
347/*
348 * END Kernel control API
349 */
350
351/*
352 * lttng_get_readable_code
353 *
354 * Return a human readable string of code
355 */
356const char *lttng_get_readable_code(int code)
357{
358 if (code > -LTTCOMM_OK) {
359 return "Ended with errors";
360 }
361
362 return lttcomm_get_readable_code(code);
363}
364
365/*
366 * lttng_ust_list_apps
367 *
368 * Ask the session daemon for all UST traceable applications.
369 *
370 * Return the number of pids.
371 * On error, return negative value.
372 */
373int lttng_ust_list_traceable_apps(pid_t **pids)
374{
375 int ret;
376
377 ret = ask_sessiond(LTTNG_LIST_TRACEABLE_APPS, (void**) pids);
378 if (ret < 0) {
379 return ret;
380 }
381
382 return ret / sizeof(pid_t);
383}
384
385/*
386 * lttng_list_traces
387 *
388 * Ask the session daemon for all traces (kernel and ust) for the session
389 * identified by name.
390 *
391 * Return the number of traces.
392 * On error, return negative value.
393 */
394/*
395int lttng_list_traces(char *session_name, struct lttng_trace **traces)
396{
397 int ret;
398
399 strncpy(lsm.session_name, session_name, NAME_MAX);
400
401 ret = ask_sessiond(LTTNG_LIST_TRACES, (void **) traces);
402 if (ret < 0) {
403 return ret;
404 }
405
406 return ret / sizeof(struct lttng_trace);
407}
408*/
409
410/*
411 * lttng_create_session
412 *
413 * Create a brand new session using name.
414 */
415int lttng_create_session(char *name, char *path)
416{
417 strncpy(lsm.session_name, name, NAME_MAX);
418 strncpy(lsm.path, path, PATH_MAX);
419 return ask_sessiond(LTTNG_CREATE_SESSION, NULL);
420}
421
422/*
423 * lttng_destroy_session
424 *
425 * Destroy session using name.
426 */
427int lttng_destroy_session(char *name)
428{
429 strncpy(lsm.session_name, name, NAME_MAX);
430 return ask_sessiond(LTTNG_DESTROY_SESSION, NULL);
431}
432
433/*
434 * lttng_list_sessions
435 *
436 * Ask the session daemon for all available sessions.
437 *
438 * Return number of session.
439 * On error, return negative value.
440 */
441int lttng_list_sessions(struct lttng_session **sessions)
442{
443 int ret;
444
445 ret = ask_sessiond(LTTNG_LIST_SESSIONS, (void**) sessions);
446 if (ret < 0) {
447 return ret;
448 }
449
450 return ret / sizeof(struct lttng_session);
451}
452
453/*
454 * lttng_connect_sessiond
455 *
456 * Connect to the LTTng session daemon.
457 * On success, return 0
458 * On error, return a negative value
459 */
460int lttng_connect_sessiond(void)
461{
462 int ret;
463
464 ret = set_session_daemon_path();
465 if (ret < 0) {
466 return ret;
467 }
468
469 /* Connect to the sesssion daemon */
470 ret = lttcomm_connect_unix_sock(sessiond_sock_path);
471 if (ret < 0) {
472 return ret;
473 }
474
475 sessiond_socket = ret;
476 connected = 1;
477
478 return 0;
479}
480
481/*
482 * lttng_disconnect_sessiond
483 *
484 * Clean disconnect the session daemon.
485 */
486int lttng_disconnect_sessiond(void)
487{
488 int ret = 0;
489
490 if (connected) {
491 ret = lttcomm_close_unix_sock(sessiond_socket);
492 sessiond_socket = 0;
493 connected = 0;
494 }
495
496 return ret;
497}
498
499void lttng_set_session_name(char *name)
500{
501 strncpy(lsm.session_name, name, NAME_MAX);
502}
503
504/*
505 * lttng_set_tracing_group
506 *
507 * Set tracing group variable with name. This function
508 * allocate memory pointed by tracing_group.
509 */
510int lttng_set_tracing_group(const char *name)
511{
512 if (asprintf(&tracing_group, "%s", name) < 0) {
513 return -ENOMEM;
514 }
515
516 return 0;
517}
518
519/*
520 * lttng_check_session_daemon
521 *
522 * Yes, return 1
523 * No, return 0
524 * Error, return negative value
525 */
526int lttng_session_daemon_alive(void)
527{
528 int ret;
529
530 ret = set_session_daemon_path();
531 if (ret < 0) {
532 /* Error */
533 return ret;
534 }
535
536 /* If socket exist, we consider the daemon started */
537 ret = access(sessiond_sock_path, F_OK);
538 if (ret < 0) {
539 /* Not alive */
540 return 0;
541 }
542
543 /* Is alive */
544 return 1;
545}
546
547/*
548 * lib constructor
549 */
550static void __attribute__((constructor)) init()
551{
552 /* Set default session group */
553 lttng_set_tracing_group(LTTNG_DEFAULT_TRACING_GROUP);
554}
This page took 0.025378 seconds and 5 git commands to generate.