lttng-ctl: fix: lttng_data_pending confuses communication status
[lttng-tools.git] / src / lib / lttng-ctl / lttng-ctl.c
CommitLineData
826d496d 1/*
eb5c4f4e 2 * lttng-ctl.c
82a3637f
DG
3 *
4 * Linux Trace Toolkit Control Library
5 *
826d496d 6 * Copyright (C) 2011 David Goulet <david.goulet@polymtl.ca>
2001793c 7 * Copyright (C) 2016 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
fac6795d 8 *
d14d33bf
AM
9 * This library is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU Lesser General Public License, version 2.1 only,
11 * as published by the Free Software Foundation.
82a3637f
DG
12 *
13 * This library is distributed in the hope that it will be useful,
fac6795d 14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
82a3637f
DG
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
17 *
d14d33bf
AM
18 * You should have received a copy of the GNU Lesser General Public License
19 * along with this library; if not, write to the Free Software Foundation,
20 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
fac6795d
DG
21 */
22
6c1c0768 23#define _LGPL_SOURCE
44a5e5eb 24#include <assert.h>
fac6795d 25#include <grp.h>
1e307fab 26#include <errno.h>
fac6795d
DG
27#include <stdio.h>
28#include <stdlib.h>
29#include <string.h>
30#include <unistd.h>
31
990570ed 32#include <common/common.h>
15e37663 33#include <common/compat/string.h>
990570ed 34#include <common/defaults.h>
db758600 35#include <common/sessiond-comm/sessiond-comm.h>
a4b92340 36#include <common/uri.h>
feb0f3e5 37#include <common/utils.h>
de453daa 38#include <common/dynamic-buffer.h>
1e307fab 39#include <lttng/lttng.h>
0c89d795 40#include <lttng/health-internal.h>
a58c490f
JG
41#include <lttng/trigger/trigger-internal.h>
42#include <lttng/endpoint.h>
43#include <lttng/channel-internal.h>
de453daa 44#include <lttng/event-internal.h>
15e37663 45#include <lttng/userspace-probe-internal.h>
b178f53e
JG
46#include <lttng/session-internal.h>
47#include <lttng/session-descriptor-internal.h>
3e3665b8 48#include <lttng/destruction-handle.h>
fac6795d 49
d00c599e
DG
50#include "filter/filter-ast.h"
51#include "filter/filter-parser.h"
52#include "filter/filter-bytecode.h"
53#include "filter/memstream.h"
cac3069d 54#include "lttng-ctl-helper.h"
53a80697
MD
55
56#ifdef DEBUG
d00c599e 57static const int print_xml = 1;
53a80697
MD
58#define dbg_printf(fmt, args...) \
59 printf("[debug liblttng-ctl] " fmt, ## args)
60#else
d00c599e 61static const int print_xml = 0;
53a80697
MD
62#define dbg_printf(fmt, args...) \
63do { \
64 /* do nothing but check printf format */ \
65 if (0) \
66 printf("[debug liblttnctl] " fmt, ## args); \
67} while (0)
68#endif
69
70
fac6795d 71/* Socket to session daemon for communication */
3e3665b8 72static int sessiond_socket = -1;
fac6795d
DG
73static char sessiond_sock_path[PATH_MAX];
74
fac6795d
DG
75/* Variables */
76static char *tracing_group;
77static int connected;
78
97e19046
DG
79/* Global */
80
81/*
82 * Those two variables are used by error.h to silent or control the verbosity of
83 * error message. They are global to the library so application linking with it
84 * are able to compile correctly and also control verbosity of the library.
97e19046
DG
85 */
86int lttng_opt_quiet;
87int lttng_opt_verbose;
c7e35b03 88int lttng_opt_mi;
97e19046 89
99497cd0
MD
90/*
91 * Copy string from src to dst and enforce null terminated byte.
92 */
cac3069d
DG
93LTTNG_HIDDEN
94void lttng_ctl_copy_string(char *dst, const char *src, size_t len)
99497cd0 95{
e7d6716d 96 if (src && dst) {
99497cd0
MD
97 strncpy(dst, src, len);
98 /* Enforce the NULL terminated byte */
99 dst[len - 1] = '\0';
cd80958d
DG
100 } else if (dst) {
101 dst[0] = '\0';
99497cd0
MD
102 }
103}
104
fac6795d 105/*
cd80958d 106 * Copy domain to lttcomm_session_msg domain.
fac6795d 107 *
cd80958d
DG
108 * If domain is unknown, default domain will be the kernel.
109 */
cac3069d
DG
110LTTNG_HIDDEN
111void lttng_ctl_copy_lttng_domain(struct lttng_domain *dst,
112 struct lttng_domain *src)
cd80958d
DG
113{
114 if (src && dst) {
115 switch (src->type) {
00e2e675
DG
116 case LTTNG_DOMAIN_KERNEL:
117 case LTTNG_DOMAIN_UST:
b9dfb167 118 case LTTNG_DOMAIN_JUL:
5cdb6027 119 case LTTNG_DOMAIN_LOG4J:
0e115563 120 case LTTNG_DOMAIN_PYTHON:
00e2e675
DG
121 memcpy(dst, src, sizeof(struct lttng_domain));
122 break;
123 default:
124 memset(dst, 0, sizeof(struct lttng_domain));
00e2e675 125 break;
cd80958d
DG
126 }
127 }
128}
129
130/*
131 * Send lttcomm_session_msg to the session daemon.
fac6795d 132 *
1c8d13c8
TD
133 * On success, returns the number of bytes sent (>=0)
134 * On error, returns -1
fac6795d 135 */
cd80958d 136static int send_session_msg(struct lttcomm_session_msg *lsm)
fac6795d
DG
137{
138 int ret;
139
140 if (!connected) {
2f70b271 141 ret = -LTTNG_ERR_NO_SESSIOND;
e065084a 142 goto end;
fac6795d
DG
143 }
144
a4b92340
DG
145 DBG("LSM cmd type : %d", lsm->cmd_type);
146
be040666 147 ret = lttcomm_send_creds_unix_sock(sessiond_socket, lsm,
cd80958d 148 sizeof(struct lttcomm_session_msg));
2f70b271
DG
149 if (ret < 0) {
150 ret = -LTTNG_ERR_FATAL;
151 }
e065084a
DG
152
153end:
154 return ret;
155}
156
53a80697
MD
157/*
158 * Send var len data to the session daemon.
159 *
160 * On success, returns the number of bytes sent (>=0)
161 * On error, returns -1
162 */
c2d69327 163static int send_session_varlen(const void *data, size_t len)
53a80697
MD
164{
165 int ret;
166
167 if (!connected) {
2f70b271 168 ret = -LTTNG_ERR_NO_SESSIOND;
53a80697
MD
169 goto end;
170 }
a4b92340 171
53a80697
MD
172 if (!data || !len) {
173 ret = 0;
174 goto end;
175 }
176
177 ret = lttcomm_send_unix_sock(sessiond_socket, data, len);
2f70b271
DG
178 if (ret < 0) {
179 ret = -LTTNG_ERR_FATAL;
180 }
53a80697
MD
181
182end:
183 return ret;
184}
185
a04d53fc
FD
186/*
187 * Send file descriptors to the session daemon.
188 *
189 * On success, returns the number of bytes sent (>=0)
190 * On error, returns -1
191 */
192static int send_session_fds(const int *fds, size_t nb_fd)
193{
194 int ret;
195
196 if (!connected) {
197 ret = -LTTNG_ERR_NO_SESSIOND;
198 goto end;
199 }
200
201 if (!fds || !nb_fd) {
202 ret = 0;
203 goto end;
204 }
205
206 ret = lttcomm_send_fds_unix_sock(sessiond_socket, fds, nb_fd);
207 if (ret < 0) {
208 ret = -LTTNG_ERR_FATAL;
209 }
210
211end:
212 return ret;
213}
214
e065084a 215/*
cd80958d 216 * Receive data from the sessiond socket.
e065084a 217 *
1c8d13c8
TD
218 * On success, returns the number of bytes received (>=0)
219 * On error, returns -1 (recvmsg() error) or -ENOTCONN
e065084a 220 */
ca95a216 221static int recv_data_sessiond(void *buf, size_t len)
e065084a
DG
222{
223 int ret;
224
225 if (!connected) {
2f70b271 226 ret = -LTTNG_ERR_NO_SESSIOND;
e065084a 227 goto end;
fac6795d
DG
228 }
229
ca95a216 230 ret = lttcomm_recv_unix_sock(sessiond_socket, buf, len);
2f70b271
DG
231 if (ret < 0) {
232 ret = -LTTNG_ERR_FATAL;
233 }
fac6795d 234
e065084a 235end:
fac6795d
DG
236 return ret;
237}
238
239/*
9ae110e2 240 * Check if we are in the specified group.
65beb5ff 241 *
9ae110e2 242 * If yes return 1, else return -1.
947308c4 243 */
6c71277b
MD
244LTTNG_HIDDEN
245int lttng_check_tracing_group(void)
947308c4 246{
28ab59d0 247 gid_t *grp_list, tracing_gid;
947308c4
DG
248 int grp_list_size, grp_id, i;
249 int ret = -1;
6c71277b 250 const char *grp_name = tracing_group;
947308c4
DG
251
252 /* Get GID of group 'tracing' */
28ab59d0 253 if (utils_get_group_id(grp_name, false, &tracing_gid)) {
b4d8603b 254 /* If grp_tracing is NULL, the group does not exist. */
947308c4
DG
255 goto end;
256 }
257
258 /* Get number of supplementary group IDs */
259 grp_list_size = getgroups(0, NULL);
260 if (grp_list_size < 0) {
6f04ed72 261 PERROR("getgroups");
947308c4
DG
262 goto end;
263 }
264
265 /* Alloc group list of the right size */
3f451dc0 266 grp_list = zmalloc(grp_list_size * sizeof(gid_t));
00795392 267 if (!grp_list) {
6f04ed72 268 PERROR("malloc");
00795392
MD
269 goto end;
270 }
947308c4 271 grp_id = getgroups(grp_list_size, grp_list);
1c8d13c8 272 if (grp_id < 0) {
6f04ed72 273 PERROR("getgroups");
947308c4
DG
274 goto free_list;
275 }
276
277 for (i = 0; i < grp_list_size; i++) {
28ab59d0 278 if (grp_list[i] == tracing_gid) {
2269e89e 279 ret = 1;
947308c4
DG
280 break;
281 }
282 }
283
284free_list:
285 free(grp_list);
286
287end:
288 return ret;
289}
290
09b72f7a
FD
291static int check_enough_available_memory(size_t num_bytes_requested_per_cpu)
292{
293 int ret;
294 long num_cpu;
295 size_t best_mem_info;
296 size_t num_bytes_requested_total;
297
298 /*
299 * Get the number of CPU currently online to compute the amount of
300 * memory needed to create a buffer for every CPU.
301 */
302 num_cpu = sysconf(_SC_NPROCESSORS_ONLN);
303 if (num_cpu == -1) {
304 goto error;
305 }
306
307 num_bytes_requested_total = num_bytes_requested_per_cpu * num_cpu;
308
309 /*
310 * Try to get the `MemAvail` field of `/proc/meminfo`. This is the most
311 * reliable estimate we can get but it is only exposed by the kernel
312 * since 3.14. (See Linux kernel commit:
313 * 34e431b0ae398fc54ea69ff85ec700722c9da773)
314 */
315 ret = utils_get_memory_available(&best_mem_info);
316 if (ret >= 0) {
317 goto success;
318 }
319
320 /*
321 * As a backup plan, use `MemTotal` field of `/proc/meminfo`. This
322 * is a sanity check for obvious user error.
323 */
324 ret = utils_get_memory_total(&best_mem_info);
325 if (ret >= 0) {
326 goto success;
327 }
328
329error:
330 return -1;
331success:
332 return best_mem_info >= num_bytes_requested_total;
333}
334
947308c4 335/*
2269e89e
DG
336 * Try connect to session daemon with sock_path.
337 *
338 * Return 0 on success, else -1
339 */
340static int try_connect_sessiond(const char *sock_path)
341{
342 int ret;
343
344 /* If socket exist, we check if the daemon listens for connect. */
345 ret = access(sock_path, F_OK);
346 if (ret < 0) {
347 /* Not alive */
2f70b271 348 goto error;
2269e89e
DG
349 }
350
351 ret = lttcomm_connect_unix_sock(sock_path);
352 if (ret < 0) {
9ae110e2 353 /* Not alive. */
2f70b271 354 goto error;
2269e89e
DG
355 }
356
357 ret = lttcomm_close_unix_sock(ret);
358 if (ret < 0) {
6f04ed72 359 PERROR("lttcomm_close_unix_sock");
2269e89e
DG
360 }
361
362 return 0;
2f70b271
DG
363
364error:
365 return -1;
2269e89e
DG
366}
367
368/*
2f70b271
DG
369 * Set sessiond socket path by putting it in the global sessiond_sock_path
370 * variable.
371 *
372 * Returns 0 on success, negative value on failure (the sessiond socket path
373 * is somehow too long or ENOMEM).
947308c4
DG
374 */
375static int set_session_daemon_path(void)
376{
9ae110e2 377 int in_tgroup = 0; /* In tracing group. */
2269e89e
DG
378 uid_t uid;
379
380 uid = getuid();
947308c4 381
2269e89e
DG
382 if (uid != 0) {
383 /* Are we in the tracing group ? */
6c71277b 384 in_tgroup = lttng_check_tracing_group();
2269e89e
DG
385 }
386
08a9c49f 387 if ((uid == 0) || in_tgroup) {
cac3069d
DG
388 lttng_ctl_copy_string(sessiond_sock_path,
389 DEFAULT_GLOBAL_CLIENT_UNIX_SOCK, sizeof(sessiond_sock_path));
08a9c49f 390 }
2269e89e 391
08a9c49f 392 if (uid != 0) {
c617c0c6
MD
393 int ret;
394
08a9c49f 395 if (in_tgroup) {
9ae110e2 396 /* Tracing group. */
08a9c49f
TD
397 ret = try_connect_sessiond(sessiond_sock_path);
398 if (ret >= 0) {
399 goto end;
2269e89e 400 }
08a9c49f 401 /* Global session daemon not available... */
2269e89e 402 }
08a9c49f
TD
403 /* ...or not in tracing group (and not root), default */
404
405 /*
9ae110e2
JG
406 * With GNU C < 2.1, snprintf returns -1 if the target buffer
407 * is too small;
408 * With GNU C >= 2.1, snprintf returns the required size
409 * (excluding closing null)
08a9c49f
TD
410 */
411 ret = snprintf(sessiond_sock_path, sizeof(sessiond_sock_path),
feb0f3e5 412 DEFAULT_HOME_CLIENT_UNIX_SOCK, utils_get_home_dir());
08a9c49f 413 if ((ret < 0) || (ret >= sizeof(sessiond_sock_path))) {
2f70b271 414 goto error;
947308c4 415 }
947308c4 416 }
08a9c49f 417end:
947308c4 418 return 0;
2f70b271
DG
419
420error:
421 return -1;
947308c4
DG
422}
423
65beb5ff 424/*
9ae110e2 425 * Connect to the LTTng session daemon.
65beb5ff 426 *
3e3665b8 427 * On success, return the socket's file descriptor. On error, return -1.
65beb5ff 428 */
3e3665b8 429LTTNG_HIDDEN int connect_sessiond(void)
65beb5ff
DG
430{
431 int ret;
432
433 ret = set_session_daemon_path();
434 if (ret < 0) {
2f70b271 435 goto error;
65beb5ff
DG
436 }
437
9ae110e2 438 /* Connect to the sesssion daemon. */
65beb5ff
DG
439 ret = lttcomm_connect_unix_sock(sessiond_sock_path);
440 if (ret < 0) {
2f70b271 441 goto error;
65beb5ff
DG
442 }
443
3e3665b8 444 return ret;
2f70b271
DG
445
446error:
447 return -1;
65beb5ff
DG
448}
449
3e3665b8
JG
450static void reset_global_sessiond_connection_state(void)
451{
452 sessiond_socket = -1;
453 connected = 0;
454}
455
65beb5ff 456/*
1c8d13c8 457 * Clean disconnect from the session daemon.
9ae110e2 458 *
1c8d13c8 459 * On success, return 0. On error, return -1.
65beb5ff
DG
460 */
461static int disconnect_sessiond(void)
462{
463 int ret = 0;
464
465 if (connected) {
466 ret = lttcomm_close_unix_sock(sessiond_socket);
3e3665b8 467 reset_global_sessiond_connection_state();
65beb5ff
DG
468 }
469
470 return ret;
471}
472
795a978d
PP
473static int recv_sessiond_optional_data(size_t len, void **user_buf,
474 size_t *user_len)
475{
476 int ret = 0;
477 void *buf = NULL;
478
479 if (len) {
480 if (!user_len) {
481 ret = -LTTNG_ERR_INVALID;
482 goto end;
483 }
484
485 buf = zmalloc(len);
486 if (!buf) {
487 ret = -ENOMEM;
488 goto end;
489 }
490
491 ret = recv_data_sessiond(buf, len);
492 if (ret < 0) {
493 goto end;
494 }
495
496 if (!user_buf) {
497 ret = -LTTNG_ERR_INVALID;
498 goto end;
499 }
500
501 /* Move ownership of command header buffer to user. */
502 *user_buf = buf;
503 buf = NULL;
504 *user_len = len;
505 } else {
506 /* No command header. */
507 if (user_len) {
508 *user_len = 0;
509 }
510
511 if (user_buf) {
512 *user_buf = NULL;
513 }
514 }
515
516end:
517 free(buf);
518 return ret;
519}
520
35a6fdb7 521/*
cd80958d 522 * Ask the session daemon a specific command and put the data into buf.
a04d53fc
FD
523 * Takes extra var. len. data and file descriptors as input to send to the
524 * session daemon.
65beb5ff 525 *
af87c45a 526 * Return size of data (only payload, not header) or a negative error code.
65beb5ff 527 */
cac3069d 528LTTNG_HIDDEN
a04d53fc
FD
529int lttng_ctl_ask_sessiond_fds_varlen(struct lttcomm_session_msg *lsm,
530 const int *fds, size_t nb_fd, const void *vardata,
531 size_t vardata_len, void **user_payload_buf,
532 void **user_cmd_header_buf, size_t *user_cmd_header_len)
65beb5ff
DG
533{
534 int ret;
795a978d 535 size_t payload_len;
cd80958d 536 struct lttcomm_lttng_msg llm;
65beb5ff
DG
537
538 ret = connect_sessiond();
539 if (ret < 0) {
2f70b271 540 ret = -LTTNG_ERR_NO_SESSIOND;
65beb5ff 541 goto end;
3e3665b8
JG
542 } else {
543 sessiond_socket = ret;
544 connected = 1;
65beb5ff
DG
545 }
546
65beb5ff 547 /* Send command to session daemon */
cd80958d 548 ret = send_session_msg(lsm);
65beb5ff 549 if (ret < 0) {
2f70b271 550 /* Ret value is a valid lttng error code. */
65beb5ff
DG
551 goto end;
552 }
53a80697 553 /* Send var len data */
795a978d 554 ret = send_session_varlen(vardata, vardata_len);
53a80697 555 if (ret < 0) {
2f70b271 556 /* Ret value is a valid lttng error code. */
53a80697
MD
557 goto end;
558 }
65beb5ff 559
a04d53fc
FD
560 /* Send fds */
561 ret = send_session_fds(fds, nb_fd);
562 if (ret < 0) {
563 /* Ret value is a valid lttng error code. */
564 goto end;
565 }
566
65beb5ff
DG
567 /* Get header from data transmission */
568 ret = recv_data_sessiond(&llm, sizeof(llm));
569 if (ret < 0) {
2f70b271 570 /* Ret value is a valid lttng error code. */
65beb5ff
DG
571 goto end;
572 }
573
574 /* Check error code if OK */
f73fabfd 575 if (llm.ret_code != LTTNG_OK) {
65beb5ff
DG
576 ret = -llm.ret_code;
577 goto end;
578 }
579
795a978d
PP
580 /* Get command header from data transmission */
581 ret = recv_sessiond_optional_data(llm.cmd_header_size,
582 user_cmd_header_buf, user_cmd_header_len);
65beb5ff 583 if (ret < 0) {
65beb5ff
DG
584 goto end;
585 }
586
795a978d
PP
587 /* Get payload from data transmission */
588 ret = recv_sessiond_optional_data(llm.data_size, user_payload_buf,
589 &payload_len);
590 if (ret < 0) {
83009e5e
DG
591 goto end;
592 }
593
795a978d 594 ret = llm.data_size;
65beb5ff
DG
595
596end:
597 disconnect_sessiond();
598 return ret;
599}
600
9f19cc17 601/*
cd80958d 602 * Create lttng handle and return pointer.
9ae110e2 603 *
1c8d13c8 604 * The returned pointer will be NULL in case of malloc() error.
9f19cc17 605 */
cd80958d
DG
606struct lttng_handle *lttng_create_handle(const char *session_name,
607 struct lttng_domain *domain)
9f19cc17 608{
2f70b271
DG
609 struct lttng_handle *handle = NULL;
610
3f451dc0 611 handle = zmalloc(sizeof(struct lttng_handle));
cd80958d 612 if (handle == NULL) {
2f70b271 613 PERROR("malloc handle");
cd80958d
DG
614 goto end;
615 }
616
617 /* Copy session name */
cac3069d 618 lttng_ctl_copy_string(handle->session_name, session_name,
cd80958d
DG
619 sizeof(handle->session_name));
620
95681498
JG
621 /* Copy lttng domain or leave initialized to 0. */
622 if (domain) {
623 lttng_ctl_copy_lttng_domain(&handle->domain, domain);
624 }
cd80958d
DG
625
626end:
627 return handle;
628}
629
630/*
631 * Destroy handle by free(3) the pointer.
632 */
633void lttng_destroy_handle(struct lttng_handle *handle)
634{
0e428499 635 free(handle);
eb354453
DG
636}
637
d9800920
DG
638/*
639 * Register an outside consumer.
9ae110e2 640 *
1c8d13c8 641 * Returns size of returned session payload data or a negative error code.
d9800920
DG
642 */
643int lttng_register_consumer(struct lttng_handle *handle,
644 const char *socket_path)
645{
646 struct lttcomm_session_msg lsm;
647
2f70b271
DG
648 if (handle == NULL || socket_path == NULL) {
649 return -LTTNG_ERR_INVALID;
650 }
651
53efb85a 652 memset(&lsm, 0, sizeof(lsm));
d9800920 653 lsm.cmd_type = LTTNG_REGISTER_CONSUMER;
cac3069d 654 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
d9800920 655 sizeof(lsm.session.name));
cac3069d 656 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
d9800920 657
9ae110e2
JG
658 lttng_ctl_copy_string(lsm.u.reg.path, socket_path,
659 sizeof(lsm.u.reg.path));
d9800920 660
cac3069d 661 return lttng_ctl_ask_sessiond(&lsm, NULL);
d9800920
DG
662}
663
1df4dedd 664/*
9ae110e2
JG
665 * Start tracing for all traces of the session.
666 *
667 * Returns size of returned session payload data or a negative error code.
1df4dedd 668 */
6a4f824d 669int lttng_start_tracing(const char *session_name)
f3ed775e 670{
cd80958d
DG
671 struct lttcomm_session_msg lsm;
672
6a4f824d 673 if (session_name == NULL) {
2f70b271 674 return -LTTNG_ERR_INVALID;
cd80958d
DG
675 }
676
53efb85a 677 memset(&lsm, 0, sizeof(lsm));
cd80958d 678 lsm.cmd_type = LTTNG_START_TRACE;
6a4f824d 679
cac3069d
DG
680 lttng_ctl_copy_string(lsm.session.name, session_name,
681 sizeof(lsm.session.name));
cd80958d 682
cac3069d 683 return lttng_ctl_ask_sessiond(&lsm, NULL);
f3ed775e 684}
1df4dedd
DG
685
686/*
38ee087f 687 * Stop tracing for all traces of the session.
f3ed775e 688 */
38ee087f 689static int _lttng_stop_tracing(const char *session_name, int wait)
f3ed775e 690{
38ee087f 691 int ret, data_ret;
cd80958d
DG
692 struct lttcomm_session_msg lsm;
693
6a4f824d 694 if (session_name == NULL) {
2f70b271 695 return -LTTNG_ERR_INVALID;
6a4f824d
DG
696 }
697
53efb85a 698 memset(&lsm, 0, sizeof(lsm));
cd80958d 699 lsm.cmd_type = LTTNG_STOP_TRACE;
6a4f824d 700
cac3069d
DG
701 lttng_ctl_copy_string(lsm.session.name, session_name,
702 sizeof(lsm.session.name));
cd80958d 703
cac3069d 704 ret = lttng_ctl_ask_sessiond(&lsm, NULL);
38ee087f
DG
705 if (ret < 0 && ret != -LTTNG_ERR_TRACE_ALREADY_STOPPED) {
706 goto error;
707 }
708
709 if (!wait) {
710 goto end;
711 }
712
38ee087f
DG
713 /* Check for data availability */
714 do {
6d805429 715 data_ret = lttng_data_pending(session_name);
38ee087f
DG
716 if (data_ret < 0) {
717 /* Return the data available call error. */
718 ret = data_ret;
719 goto error;
720 }
721
722 /*
9ae110e2
JG
723 * Data sleep time before retrying (in usec). Don't sleep if the
724 * call returned value indicates availability.
38ee087f 725 */
6d805429 726 if (data_ret) {
c8f61fd4 727 usleep(DEFAULT_DATA_AVAILABILITY_WAIT_TIME_US);
38ee087f 728 }
6d805429 729 } while (data_ret != 0);
38ee087f 730
38ee087f
DG
731end:
732error:
733 return ret;
734}
735
736/*
737 * Stop tracing and wait for data availability.
738 */
739int lttng_stop_tracing(const char *session_name)
740{
741 return _lttng_stop_tracing(session_name, 1);
742}
743
744/*
745 * Stop tracing but _don't_ wait for data availability.
746 */
747int lttng_stop_tracing_no_wait(const char *session_name)
748{
749 return _lttng_stop_tracing(session_name, 0);
f3ed775e
DG
750}
751
752/*
601d5acf
DG
753 * Add context to a channel.
754 *
755 * If the given channel is NULL, add the contexts to all channels.
756 * The event_name param is ignored.
af87c45a
DG
757 *
758 * Returns the size of the returned payload data or a negative error code.
1df4dedd 759 */
cd80958d 760int lttng_add_context(struct lttng_handle *handle,
38057ed1
DG
761 struct lttng_event_context *ctx, const char *event_name,
762 const char *channel_name)
d65106b1 763{
2001793c
JG
764 int ret;
765 size_t len = 0;
766 char *buf = NULL;
cd80958d
DG
767 struct lttcomm_session_msg lsm;
768
9ae110e2 769 /* Safety check. Both are mandatory. */
9d697d3d 770 if (handle == NULL || ctx == NULL) {
2001793c
JG
771 ret = -LTTNG_ERR_INVALID;
772 goto end;
cd80958d
DG
773 }
774
441c16a7 775 memset(&lsm, 0, sizeof(lsm));
cd80958d
DG
776 lsm.cmd_type = LTTNG_ADD_CONTEXT;
777
85076754
MD
778 /* If no channel name, send empty string. */
779 if (channel_name == NULL) {
780 lttng_ctl_copy_string(lsm.u.context.channel_name, "",
781 sizeof(lsm.u.context.channel_name));
782 } else {
783 lttng_ctl_copy_string(lsm.u.context.channel_name, channel_name,
784 sizeof(lsm.u.context.channel_name));
785 }
cd80958d 786
cac3069d 787 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
cac3069d 788 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d
DG
789 sizeof(lsm.session.name));
790
2001793c
JG
791 if (ctx->ctx == LTTNG_EVENT_CONTEXT_APP_CONTEXT) {
792 size_t provider_len, ctx_len;
793 const char *provider_name = ctx->u.app_ctx.provider_name;
794 const char *ctx_name = ctx->u.app_ctx.ctx_name;
795
796 if (!provider_name || !ctx_name) {
797 ret = -LTTNG_ERR_INVALID;
798 goto end;
799 }
800
801 provider_len = strlen(provider_name);
802 if (provider_len == 0) {
803 ret = -LTTNG_ERR_INVALID;
804 goto end;
805 }
806 lsm.u.context.provider_name_len = provider_len;
807
808 ctx_len = strlen(ctx_name);
809 if (ctx_len == 0) {
810 ret = -LTTNG_ERR_INVALID;
811 goto end;
812 }
813 lsm.u.context.context_name_len = ctx_len;
814
815 len = provider_len + ctx_len;
816 buf = zmalloc(len);
817 if (!buf) {
818 ret = -LTTNG_ERR_NOMEM;
819 goto end;
820 }
821
822 memcpy(buf, provider_name, provider_len);
823 memcpy(buf + provider_len, ctx_name, ctx_len);
824 }
825 memcpy(&lsm.u.context.ctx, ctx, sizeof(struct lttng_event_context));
46f44e2a
JR
826
827 if (ctx->ctx == LTTNG_EVENT_CONTEXT_APP_CONTEXT) {
828 /*
829 * Don't leak application addresses to the sessiond.
830 * This is only necessary when ctx is for an app ctx otherwise
831 * the values inside the union (type & config) are overwritten.
832 */
833 lsm.u.context.ctx.u.app_ctx.provider_name = NULL;
834 lsm.u.context.ctx.u.app_ctx.ctx_name = NULL;
835 }
2001793c 836
795a978d 837 ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, buf, len, NULL);
2001793c
JG
838end:
839 free(buf);
840 return ret;
d65106b1
DG
841}
842
f3ed775e 843/*
9ae110e2
JG
844 * Enable event(s) for a channel.
845 *
846 * If no event name is specified, all events are enabled.
847 * If no channel name is specified, the default 'channel0' is used.
848 *
849 * Returns size of returned session payload data or a negative error code.
f3ed775e 850 */
cd80958d 851int lttng_enable_event(struct lttng_handle *handle,
38057ed1 852 struct lttng_event *ev, const char *channel_name)
1df4dedd 853{
f8a96544
JI
854 return lttng_enable_event_with_exclusions(handle, ev, channel_name,
855 NULL, 0, NULL);
1df4dedd
DG
856}
857
53a80697 858/*
025faf73 859 * Create or enable an event with a filter expression.
178191b3 860 *
53a80697
MD
861 * Return negative error value on error.
862 * Return size of returned session payload data if OK.
863 */
025faf73 864int lttng_enable_event_with_filter(struct lttng_handle *handle,
178191b3 865 struct lttng_event *event, const char *channel_name,
53a80697
MD
866 const char *filter_expression)
867{
f8a96544
JI
868 return lttng_enable_event_with_exclusions(handle, event, channel_name,
869 filter_expression, 0, NULL);
53a80697
MD
870}
871
347c5ab5 872/*
0e115563 873 * Depending on the event, return a newly allocated agent filter expression or
347c5ab5
DG
874 * NULL if not applicable.
875 *
876 * An event with NO loglevel and the name is * will return NULL.
877 */
0e115563 878static char *set_agent_filter(const char *filter, struct lttng_event *ev)
347c5ab5
DG
879{
880 int err;
0e115563 881 char *agent_filter = NULL;
347c5ab5
DG
882
883 assert(ev);
884
885 /* Don't add filter for the '*' event. */
9f449915 886 if (strcmp(ev->name, "*") != 0) {
347c5ab5 887 if (filter) {
0e115563 888 err = asprintf(&agent_filter, "(%s) && (logger_name == \"%s\")", filter,
347c5ab5
DG
889 ev->name);
890 } else {
0e115563 891 err = asprintf(&agent_filter, "logger_name == \"%s\"", ev->name);
347c5ab5
DG
892 }
893 if (err < 0) {
894 PERROR("asprintf");
6a556f7b 895 goto error;
347c5ab5
DG
896 }
897 }
898
899 /* Add loglevel filtering if any for the JUL domain. */
900 if (ev->loglevel_type != LTTNG_EVENT_LOGLEVEL_ALL) {
901 char *op;
902
903 if (ev->loglevel_type == LTTNG_EVENT_LOGLEVEL_RANGE) {
904 op = ">=";
905 } else {
906 op = "==";
907 }
908
0e115563 909 if (filter || agent_filter) {
6a556f7b
JG
910 char *new_filter;
911
fb0edb23 912 err = asprintf(&new_filter, "(%s) && (int_loglevel %s %d)",
0e115563 913 agent_filter ? agent_filter : filter, op,
347c5ab5 914 ev->loglevel);
0e115563
DG
915 if (agent_filter) {
916 free(agent_filter);
6a556f7b 917 }
0e115563 918 agent_filter = new_filter;
347c5ab5 919 } else {
0e115563 920 err = asprintf(&agent_filter, "int_loglevel %s %d", op,
347c5ab5
DG
921 ev->loglevel);
922 }
923 if (err < 0) {
924 PERROR("asprintf");
6a556f7b 925 goto error;
347c5ab5
DG
926 }
927 }
928
0e115563 929 return agent_filter;
6a556f7b 930error:
0e115563 931 free(agent_filter);
6a556f7b 932 return NULL;
347c5ab5
DG
933}
934
137b9942 935/*
ec166985 936 * Generate the filter bytecode from a given filter expression string. Put the
137b9942
DG
937 * newly allocated parser context in ctxp and populate the lsm object with the
938 * expression len.
939 *
940 * Return 0 on success else a LTTNG_ERR_* code and ctxp is untouched.
941 */
942static int generate_filter(char *filter_expression,
943 struct lttcomm_session_msg *lsm, struct filter_parser_ctx **ctxp)
944{
945 int ret;
946 struct filter_parser_ctx *ctx = NULL;
947 FILE *fmem = NULL;
948
949 assert(filter_expression);
950 assert(lsm);
951 assert(ctxp);
952
953 /*
954 * Casting const to non-const, as the underlying function will use it in
955 * read-only mode.
956 */
957 fmem = lttng_fmemopen((void *) filter_expression,
958 strlen(filter_expression), "r");
959 if (!fmem) {
960 fprintf(stderr, "Error opening memory as stream\n");
961 ret = -LTTNG_ERR_FILTER_NOMEM;
962 goto error;
963 }
964 ctx = filter_parser_ctx_alloc(fmem);
965 if (!ctx) {
966 fprintf(stderr, "Error allocating parser\n");
967 ret = -LTTNG_ERR_FILTER_NOMEM;
968 goto filter_alloc_error;
969 }
970 ret = filter_parser_ctx_append_ast(ctx);
971 if (ret) {
972 fprintf(stderr, "Parse error\n");
973 ret = -LTTNG_ERR_FILTER_INVAL;
974 goto parse_error;
975 }
137b9942
DG
976 if (print_xml) {
977 ret = filter_visitor_print_xml(ctx, stdout, 0);
978 if (ret) {
979 fflush(stdout);
980 fprintf(stderr, "XML print error\n");
981 ret = -LTTNG_ERR_FILTER_INVAL;
982 goto parse_error;
983 }
984 }
985
986 dbg_printf("Generating IR... ");
987 fflush(stdout);
988 ret = filter_visitor_ir_generate(ctx);
989 if (ret) {
990 fprintf(stderr, "Generate IR error\n");
991 ret = -LTTNG_ERR_FILTER_INVAL;
992 goto parse_error;
993 }
994 dbg_printf("done\n");
995
996 dbg_printf("Validating IR... ");
997 fflush(stdout);
998 ret = filter_visitor_ir_check_binary_op_nesting(ctx);
999 if (ret) {
1000 ret = -LTTNG_ERR_FILTER_INVAL;
1001 goto parse_error;
1002 }
9f449915
PP
1003
1004 /* Normalize globbing patterns in the expression. */
1005 ret = filter_visitor_ir_normalize_glob_patterns(ctx);
1006 if (ret) {
1007 ret = -LTTNG_ERR_FILTER_INVAL;
1008 goto parse_error;
1009 }
1010
9ae110e2 1011 /* Validate strings used as literals in the expression. */
dcd5daf2
JG
1012 ret = filter_visitor_ir_validate_string(ctx);
1013 if (ret) {
1014 ret = -LTTNG_ERR_FILTER_INVAL;
1015 goto parse_error;
1016 }
9f449915
PP
1017
1018 /* Validate globbing patterns in the expression. */
1019 ret = filter_visitor_ir_validate_globbing(ctx);
1020 if (ret) {
1021 ret = -LTTNG_ERR_FILTER_INVAL;
1022 goto parse_error;
1023 }
1024
137b9942
DG
1025 dbg_printf("done\n");
1026
1027 dbg_printf("Generating bytecode... ");
1028 fflush(stdout);
1029 ret = filter_visitor_bytecode_generate(ctx);
1030 if (ret) {
1031 fprintf(stderr, "Generate bytecode error\n");
1032 ret = -LTTNG_ERR_FILTER_INVAL;
1033 goto parse_error;
1034 }
1035 dbg_printf("done\n");
1036 dbg_printf("Size of bytecode generated: %u bytes.\n",
1037 bytecode_get_len(&ctx->bytecode->b));
1038
1039 lsm->u.enable.bytecode_len = sizeof(ctx->bytecode->b)
1040 + bytecode_get_len(&ctx->bytecode->b);
1041 lsm->u.enable.expression_len = strlen(filter_expression) + 1;
1042
1043 /* No need to keep the memory stream. */
1044 if (fclose(fmem) != 0) {
6f04ed72 1045 PERROR("fclose");
137b9942
DG
1046 }
1047
1048 *ctxp = ctx;
1049 return 0;
1050
1051parse_error:
137b9942
DG
1052 filter_ir_free(ctx);
1053 filter_parser_ctx_free(ctx);
1054filter_alloc_error:
1055 if (fclose(fmem) != 0) {
6f04ed72 1056 PERROR("fclose");
137b9942
DG
1057 }
1058error:
1059 return ret;
1060}
1061
93deb080
JI
1062/*
1063 * Enable event(s) for a channel, possibly with exclusions and a filter.
1064 * If no event name is specified, all events are enabled.
1065 * If no channel name is specified, the default name is used.
1066 * If filter expression is not NULL, the filter is set for the event.
1067 * If exclusion count is not zero, the exclusions are set for the event.
1068 * Returns size of returned session payload data or a negative error code.
1069 */
1070int lttng_enable_event_with_exclusions(struct lttng_handle *handle,
1071 struct lttng_event *ev, const char *channel_name,
e9efbcd3 1072 const char *original_filter_expression,
93deb080
JI
1073 int exclusion_count, char **exclusion_list)
1074{
1075 struct lttcomm_session_msg lsm;
15e37663
JG
1076 struct lttng_dynamic_buffer send_buffer;
1077 int ret = 0, i, fd_to_send = -1;
1078 bool send_fd = false;
137b9942 1079 unsigned int free_filter_expression = 0;
93deb080 1080 struct filter_parser_ctx *ctx = NULL;
ec005ec6 1081
6a0838b7
YL
1082 /*
1083 * We have either a filter or some exclusions, so we need to set up
1084 * a variable-length memory block from where to send the data.
1085 */
1086 lttng_dynamic_buffer_init(&send_buffer);
ec005ec6 1087
e9efbcd3
JG
1088 /*
1089 * Cast as non-const since we may replace the filter expression
1090 * by a dynamically allocated string. Otherwise, the original
1091 * string is not modified.
1092 */
1093 char *filter_expression = (char *) original_filter_expression;
93deb080
JI
1094
1095 if (handle == NULL || ev == NULL) {
137b9942
DG
1096 ret = -LTTNG_ERR_INVALID;
1097 goto error;
93deb080
JI
1098 }
1099
9ae110e2
JG
1100 /*
1101 * Empty filter string will always be rejected by the parser
93deb080
JI
1102 * anyway, so treat this corner-case early to eliminate
1103 * lttng_fmemopen error for 0-byte allocation.
1104 */
1105 if (filter_expression && filter_expression[0] == '\0') {
137b9942
DG
1106 ret = -LTTNG_ERR_INVALID;
1107 goto error;
93deb080
JI
1108 }
1109
1110 memset(&lsm, 0, sizeof(lsm));
1111
1112 /* If no channel name, send empty string. */
1113 if (channel_name == NULL) {
1114 lttng_ctl_copy_string(lsm.u.enable.channel_name, "",
1115 sizeof(lsm.u.enable.channel_name));
1116 } else {
1117 lttng_ctl_copy_string(lsm.u.enable.channel_name, channel_name,
1118 sizeof(lsm.u.enable.channel_name));
1119 }
1120
18a720cd
MD
1121 lsm.cmd_type = LTTNG_ENABLE_EVENT;
1122 if (ev->name[0] == '\0') {
1123 /* Enable all events */
1124 lttng_ctl_copy_string(ev->name, "*", sizeof(ev->name));
6565421f 1125 }
93deb080 1126
6565421f 1127 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
6e911cad 1128 /* FIXME: copying non-packed struct to packed struct. */
93deb080
JI
1129 memcpy(&lsm.u.enable.event, ev, sizeof(lsm.u.enable.event));
1130
1131 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
1132 sizeof(lsm.session.name));
1133 lsm.u.enable.exclusion_count = exclusion_count;
1134 lsm.u.enable.bytecode_len = 0;
1135
9ae110e2 1136 /* Parse filter expression. */
5cdb6027 1137 if (filter_expression != NULL || handle->domain.type == LTTNG_DOMAIN_JUL
0e115563
DG
1138 || handle->domain.type == LTTNG_DOMAIN_LOG4J
1139 || handle->domain.type == LTTNG_DOMAIN_PYTHON) {
5cdb6027 1140 if (handle->domain.type == LTTNG_DOMAIN_JUL ||
0e115563
DG
1141 handle->domain.type == LTTNG_DOMAIN_LOG4J ||
1142 handle->domain.type == LTTNG_DOMAIN_PYTHON) {
1143 char *agent_filter;
64226865 1144
347c5ab5 1145 /* Setup JUL filter if needed. */
0e115563
DG
1146 agent_filter = set_agent_filter(filter_expression, ev);
1147 if (!agent_filter) {
137b9942 1148 if (!filter_expression) {
9ae110e2
JG
1149 /*
1150 * No JUL and no filter, just skip
1151 * everything below.
1152 */
137b9942
DG
1153 goto ask_sessiond;
1154 }
64226865
DG
1155 } else {
1156 /*
9ae110e2
JG
1157 * With an agent filter, the original filter has
1158 * been added to it thus replace the filter
1159 * expression.
64226865 1160 */
0e115563 1161 filter_expression = agent_filter;
e9efbcd3 1162 free_filter_expression = 1;
9b21e6d5 1163 }
9b21e6d5 1164 }
93deb080 1165
137b9942 1166 ret = generate_filter(filter_expression, &lsm, &ctx);
93deb080 1167 if (ret) {
137b9942 1168 goto filter_error;
93deb080 1169 }
6b453b5e
JG
1170 }
1171
15e37663
JG
1172 ret = lttng_dynamic_buffer_set_capacity(&send_buffer,
1173 lsm.u.enable.bytecode_len
137b9942
DG
1174 + lsm.u.enable.expression_len
1175 + LTTNG_SYMBOL_NAME_LEN * exclusion_count);
15e37663 1176 if (ret) {
6b453b5e 1177 ret = -LTTNG_ERR_EXCLUSION_NOMEM;
7ca1dc6f 1178 goto mem_error;
6b453b5e 1179 }
137b9942 1180
9ae110e2 1181 /* Put exclusion names first in the data. */
15e37663
JG
1182 for (i = 0; i < exclusion_count; i++) {
1183 size_t exclusion_len;
1184
1185 exclusion_len = lttng_strnlen(*(exclusion_list + i),
1186 LTTNG_SYMBOL_NAME_LEN);
1187 if (exclusion_len == LTTNG_SYMBOL_NAME_LEN) {
1188 /* Exclusion is not NULL-terminated. */
1189 ret = -LTTNG_ERR_INVALID;
1190 goto mem_error;
1191 }
1192
1193 ret = lttng_dynamic_buffer_append(&send_buffer,
1194 *(exclusion_list + i),
1195 LTTNG_SYMBOL_NAME_LEN);
1196 if (ret) {
1197 goto mem_error;
1198 }
6b453b5e 1199 }
15e37663 1200
9ae110e2 1201 /* Add filter expression next. */
15e37663
JG
1202 if (filter_expression) {
1203 ret = lttng_dynamic_buffer_append(&send_buffer,
1204 filter_expression, lsm.u.enable.expression_len);
1205 if (ret) {
1206 goto mem_error;
1207 }
6b453b5e 1208 }
9ae110e2 1209 /* Add filter bytecode next. */
137b9942 1210 if (ctx && lsm.u.enable.bytecode_len != 0) {
15e37663
JG
1211 ret = lttng_dynamic_buffer_append(&send_buffer,
1212 &ctx->bytecode->b, lsm.u.enable.bytecode_len);
1213 if (ret) {
1214 goto mem_error;
1215 }
1216 }
1217 if (ev->extended.ptr) {
1218 struct lttng_event_extended *ev_ext =
1219 (struct lttng_event_extended *) ev->extended.ptr;
1220
1221 if (ev_ext->probe_location) {
1222 /*
1223 * lttng_userspace_probe_location_serialize returns the
1224 * number of bytes that was appended to the buffer.
1225 */
1226 ret = lttng_userspace_probe_location_serialize(
1227 ev_ext->probe_location, &send_buffer,
1228 &fd_to_send);
56f0bc67 1229 if (ret < 0) {
15e37663
JG
1230 goto mem_error;
1231 }
1232
1233 send_fd = fd_to_send >= 0;
1234 /*
1235 * Set the size of the userspace probe location element
1236 * of the buffer so that the receiving side knows where
1237 * to split it.
1238 */
1239 lsm.u.enable.userspace_probe_location_len = ret;
1240 }
93deb080
JI
1241 }
1242
15e37663
JG
1243 ret = lttng_ctl_ask_sessiond_fds_varlen(&lsm,
1244 send_fd ? &fd_to_send : NULL,
1245 send_fd ? 1 : 0,
1246 send_buffer.size ? send_buffer.data : NULL,
1247 send_buffer.size, NULL, NULL, 0);
93deb080 1248
7ca1dc6f
DG
1249mem_error:
1250 if (filter_expression && ctx) {
93deb080
JI
1251 filter_bytecode_free(ctx);
1252 filter_ir_free(ctx);
1253 filter_parser_ctx_free(ctx);
7ca1dc6f
DG
1254 }
1255filter_error:
1256 if (free_filter_expression) {
1257 /*
9ae110e2
JG
1258 * The filter expression has been replaced and must be freed as
1259 * it is not the original filter expression received as a
1260 * parameter.
7ca1dc6f
DG
1261 */
1262 free(filter_expression);
93deb080 1263 }
137b9942
DG
1264error:
1265 /*
9ae110e2
JG
1266 * Return directly to the caller and don't ask the sessiond since
1267 * something went wrong in the parsing of data above.
137b9942 1268 */
15e37663 1269 lttng_dynamic_buffer_reset(&send_buffer);
93deb080 1270 return ret;
3e1c9ff7
DG
1271
1272ask_sessiond:
1273 ret = lttng_ctl_ask_sessiond(&lsm, NULL);
1274 return ret;
93deb080
JI
1275}
1276
6e911cad
MD
1277int lttng_disable_event_ext(struct lttng_handle *handle,
1278 struct lttng_event *ev, const char *channel_name,
1279 const char *original_filter_expression)
1df4dedd 1280{
cd80958d 1281 struct lttcomm_session_msg lsm;
6e911cad
MD
1282 char *varlen_data;
1283 int ret = 0;
1284 unsigned int free_filter_expression = 0;
1285 struct filter_parser_ctx *ctx = NULL;
1286 /*
1287 * Cast as non-const since we may replace the filter expression
1288 * by a dynamically allocated string. Otherwise, the original
1289 * string is not modified.
1290 */
1291 char *filter_expression = (char *) original_filter_expression;
1df4dedd 1292
6e911cad
MD
1293 if (handle == NULL || ev == NULL) {
1294 ret = -LTTNG_ERR_INVALID;
1295 goto error;
1296 }
1297
9ae110e2
JG
1298 /*
1299 * Empty filter string will always be rejected by the parser
6e911cad
MD
1300 * anyway, so treat this corner-case early to eliminate
1301 * lttng_fmemopen error for 0-byte allocation.
1302 */
1303 if (filter_expression && filter_expression[0] == '\0') {
1304 ret = -LTTNG_ERR_INVALID;
1305 goto error;
cd80958d
DG
1306 }
1307
441c16a7
MD
1308 memset(&lsm, 0, sizeof(lsm));
1309
85076754
MD
1310 /* If no channel name, send empty string. */
1311 if (channel_name == NULL) {
1312 lttng_ctl_copy_string(lsm.u.disable.channel_name, "",
cd80958d 1313 sizeof(lsm.u.disable.channel_name));
f3ed775e 1314 } else {
85076754 1315 lttng_ctl_copy_string(lsm.u.disable.channel_name, channel_name,
cd80958d 1316 sizeof(lsm.u.disable.channel_name));
eb354453
DG
1317 }
1318
18a720cd 1319 lsm.cmd_type = LTTNG_DISABLE_EVENT;
f3ed775e 1320
6e911cad
MD
1321 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
1322 /* FIXME: copying non-packed struct to packed struct. */
1323 memcpy(&lsm.u.disable.event, ev, sizeof(lsm.u.disable.event));
1324
cac3069d 1325 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d 1326 sizeof(lsm.session.name));
6e911cad 1327 lsm.u.disable.bytecode_len = 0;
cd80958d 1328
6e911cad
MD
1329 /*
1330 * For the JUL domain, a filter is enforced except for the
1331 * disable all event. This is done to avoid having the event in
1332 * all sessions thus filtering by logger name.
1333 */
1334 if (filter_expression == NULL &&
1335 (handle->domain.type != LTTNG_DOMAIN_JUL &&
0e115563
DG
1336 handle->domain.type != LTTNG_DOMAIN_LOG4J &&
1337 handle->domain.type != LTTNG_DOMAIN_PYTHON)) {
6e911cad
MD
1338 goto ask_sessiond;
1339 }
1340
1341 /*
1342 * We have a filter, so we need to set up a variable-length
1343 * memory block from where to send the data.
1344 */
1345
1346 /* Parse filter expression */
1347 if (filter_expression != NULL || handle->domain.type == LTTNG_DOMAIN_JUL
0e115563
DG
1348 || handle->domain.type == LTTNG_DOMAIN_LOG4J
1349 || handle->domain.type == LTTNG_DOMAIN_PYTHON) {
6e911cad 1350 if (handle->domain.type == LTTNG_DOMAIN_JUL ||
0e115563
DG
1351 handle->domain.type == LTTNG_DOMAIN_LOG4J ||
1352 handle->domain.type == LTTNG_DOMAIN_PYTHON) {
1353 char *agent_filter;
6e911cad
MD
1354
1355 /* Setup JUL filter if needed. */
0e115563
DG
1356 agent_filter = set_agent_filter(filter_expression, ev);
1357 if (!agent_filter) {
6e911cad 1358 if (!filter_expression) {
9ae110e2
JG
1359 /*
1360 * No JUL and no filter, just skip
1361 * everything below.
1362 */
6e911cad
MD
1363 goto ask_sessiond;
1364 }
1365 } else {
1366 /*
9ae110e2
JG
1367 * With a JUL filter, the original filter has
1368 * been added to it thus replace the filter
1369 * expression.
6e911cad 1370 */
0e115563 1371 filter_expression = agent_filter;
6e911cad
MD
1372 free_filter_expression = 1;
1373 }
1374 }
1375
1376 ret = generate_filter(filter_expression, &lsm, &ctx);
1377 if (ret) {
1378 goto filter_error;
1379 }
1380 }
1381
1382 varlen_data = zmalloc(lsm.u.disable.bytecode_len
1383 + lsm.u.disable.expression_len);
1384 if (!varlen_data) {
1385 ret = -LTTNG_ERR_EXCLUSION_NOMEM;
1386 goto mem_error;
1387 }
1388
9ae110e2 1389 /* Add filter expression. */
6e911cad
MD
1390 if (lsm.u.disable.expression_len != 0) {
1391 memcpy(varlen_data,
1392 filter_expression,
1393 lsm.u.disable.expression_len);
1394 }
9ae110e2 1395 /* Add filter bytecode next. */
6e911cad
MD
1396 if (ctx && lsm.u.disable.bytecode_len != 0) {
1397 memcpy(varlen_data
1398 + lsm.u.disable.expression_len,
1399 &ctx->bytecode->b,
1400 lsm.u.disable.bytecode_len);
1401 }
1402
795a978d 1403 ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, varlen_data,
6e911cad
MD
1404 lsm.u.disable.bytecode_len + lsm.u.disable.expression_len, NULL);
1405 free(varlen_data);
1406
1407mem_error:
1408 if (filter_expression && ctx) {
1409 filter_bytecode_free(ctx);
1410 filter_ir_free(ctx);
1411 filter_parser_ctx_free(ctx);
1412 }
1413filter_error:
1414 if (free_filter_expression) {
1415 /*
9ae110e2
JG
1416 * The filter expression has been replaced and must be freed as
1417 * it is not the original filter expression received as a
1418 * parameter.
6e911cad
MD
1419 */
1420 free(filter_expression);
1421 }
1422error:
1423 /*
9ae110e2
JG
1424 * Return directly to the caller and don't ask the sessiond since
1425 * something went wrong in the parsing of data above.
6e911cad
MD
1426 */
1427 return ret;
1428
1429ask_sessiond:
1430 ret = lttng_ctl_ask_sessiond(&lsm, NULL);
1431 return ret;
1432}
1433
1434/*
9ae110e2
JG
1435 * Disable event(s) of a channel and domain.
1436 * If no event name is specified, all events are disabled.
1437 * If no channel name is specified, the default 'channel0' is used.
1438 * Returns size of returned session payload data or a negative error code.
6e911cad
MD
1439 */
1440int lttng_disable_event(struct lttng_handle *handle, const char *name,
1441 const char *channel_name)
1442{
1443 struct lttng_event ev;
1444
1445 memset(&ev, 0, sizeof(ev));
9b7431cf 1446 ev.loglevel = -1;
6e911cad
MD
1447 ev.type = LTTNG_EVENT_ALL;
1448 lttng_ctl_copy_string(ev.name, name, sizeof(ev.name));
1449 return lttng_disable_event_ext(handle, &ev, channel_name, NULL);
1df4dedd
DG
1450}
1451
cf0bcb51
JG
1452struct lttng_channel *lttng_channel_create(struct lttng_domain *domain)
1453{
1454 struct lttng_channel *channel = NULL;
1455 struct lttng_channel_extended *extended = NULL;
1456
1457 if (!domain) {
1458 goto error;
1459 }
1460
1461 /* Validate domain. */
1462 switch (domain->type) {
1463 case LTTNG_DOMAIN_UST:
1464 switch (domain->buf_type) {
1465 case LTTNG_BUFFER_PER_UID:
1466 case LTTNG_BUFFER_PER_PID:
1467 break;
1468 default:
1469 goto error;
1470 }
1471 break;
1472 case LTTNG_DOMAIN_KERNEL:
1473 if (domain->buf_type != LTTNG_BUFFER_GLOBAL) {
1474 goto error;
1475 }
1476 break;
1477 default:
1478 goto error;
1479 }
1480
1481 channel = zmalloc(sizeof(*channel));
1482 if (!channel) {
1483 goto error;
1484 }
1485
1486 extended = zmalloc(sizeof(*extended));
1487 if (!extended) {
1488 goto error;
1489 }
1490
1491 channel->attr.extended.ptr = extended;
1492
1493 lttng_channel_set_default_attr(domain, &channel->attr);
1494 return channel;
1495error:
1496 free(channel);
1497 free(extended);
1498 return NULL;
1499}
1500
1501void lttng_channel_destroy(struct lttng_channel *channel)
1502{
1503 if (!channel) {
1504 return;
1505 }
1506
1507 if (channel->attr.extended.ptr) {
1508 free(channel->attr.extended.ptr);
1509 }
1510 free(channel);
1511}
1512
1df4dedd 1513/*
9ae110e2
JG
1514 * Enable channel per domain
1515 * Returns size of returned session payload data or a negative error code.
a5c5a2bd 1516 */
cd80958d 1517int lttng_enable_channel(struct lttng_handle *handle,
cf0bcb51 1518 struct lttng_channel *in_chan)
a5c5a2bd 1519{
cd80958d 1520 struct lttcomm_session_msg lsm;
09b72f7a 1521 size_t total_buffer_size_needed_per_cpu = 0;
cd80958d 1522
9ae110e2 1523 /* NULL arguments are forbidden. No default values. */
cf0bcb51 1524 if (handle == NULL || in_chan == NULL) {
2f70b271 1525 return -LTTNG_ERR_INVALID;
cd80958d
DG
1526 }
1527
441c16a7 1528 memset(&lsm, 0, sizeof(lsm));
cf0bcb51
JG
1529 memcpy(&lsm.u.channel.chan, in_chan, sizeof(lsm.u.channel.chan));
1530 lsm.u.channel.chan.attr.extended.ptr = NULL;
441c16a7 1531
cf0bcb51
JG
1532 if (!in_chan->attr.extended.ptr) {
1533 struct lttng_channel *channel;
1534 struct lttng_channel_extended *extended;
7d29a247 1535
cf0bcb51
JG
1536 channel = lttng_channel_create(&handle->domain);
1537 if (!channel) {
1538 return -LTTNG_ERR_NOMEM;
1539 }
1540
1541 /*
1542 * Create a new channel in order to use default extended
1543 * attribute values.
1544 */
1545 extended = (struct lttng_channel_extended *)
1546 channel->attr.extended.ptr;
1547 memcpy(&lsm.u.channel.extended, extended, sizeof(*extended));
1548 lttng_channel_destroy(channel);
1549 } else {
1550 struct lttng_channel_extended *extended;
1551
1552 extended = (struct lttng_channel_extended *)
1553 in_chan->attr.extended.ptr;
1554 memcpy(&lsm.u.channel.extended, extended, sizeof(*extended));
1555 }
cd80958d 1556
09b72f7a
FD
1557 /*
1558 * Verify that the amount of memory required to create the requested
1559 * buffer is available on the system at the moment.
1560 */
1561 total_buffer_size_needed_per_cpu = lsm.u.channel.chan.attr.num_subbuf *
1562 lsm.u.channel.chan.attr.subbuf_size;
1563 if (!check_enough_available_memory(total_buffer_size_needed_per_cpu)) {
1564 return -LTTNG_ERR_NOMEM;
1565 }
1566
cf0bcb51 1567 lsm.cmd_type = LTTNG_ENABLE_CHANNEL;
cac3069d 1568 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
7d29a247 1569
cac3069d 1570 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d
DG
1571 sizeof(lsm.session.name));
1572
cac3069d 1573 return lttng_ctl_ask_sessiond(&lsm, NULL);
8c0faa1d 1574}
1df4dedd 1575
2ef84c95 1576/*
9ae110e2
JG
1577 * All tracing will be stopped for registered events of the channel.
1578 * Returns size of returned session payload data or a negative error code.
2ef84c95 1579 */
cd80958d 1580int lttng_disable_channel(struct lttng_handle *handle, const char *name)
2ef84c95 1581{
cd80958d
DG
1582 struct lttcomm_session_msg lsm;
1583
9ae110e2 1584 /* Safety check. Both are mandatory. */
9d697d3d 1585 if (handle == NULL || name == NULL) {
2f70b271 1586 return -LTTNG_ERR_INVALID;
cd80958d
DG
1587 }
1588
441c16a7
MD
1589 memset(&lsm, 0, sizeof(lsm));
1590
cd80958d 1591 lsm.cmd_type = LTTNG_DISABLE_CHANNEL;
1df4dedd 1592
cac3069d 1593 lttng_ctl_copy_string(lsm.u.disable.channel_name, name,
9d697d3d
DG
1594 sizeof(lsm.u.disable.channel_name));
1595
cac3069d 1596 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
cd80958d 1597
cac3069d 1598 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d
DG
1599 sizeof(lsm.session.name));
1600
cac3069d 1601 return lttng_ctl_ask_sessiond(&lsm, NULL);
ca95a216
DG
1602}
1603
ccf10263 1604/*
9ae110e2
JG
1605 * Add PID to session tracker.
1606 * Return 0 on success else a negative LTTng error code.
ccf10263
MD
1607 */
1608int lttng_track_pid(struct lttng_handle *handle, int pid)
1609{
1610 struct lttcomm_session_msg lsm;
1611
9ae110e2 1612 /* NULL arguments are forbidden. No default values. */
ccf10263
MD
1613 if (handle == NULL) {
1614 return -LTTNG_ERR_INVALID;
1615 }
1616
1617 memset(&lsm, 0, sizeof(lsm));
1618
1619 lsm.cmd_type = LTTNG_TRACK_PID;
1620 lsm.u.pid_tracker.pid = pid;
1621
1622 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
1623
1624 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
1625 sizeof(lsm.session.name));
1626
1627 return lttng_ctl_ask_sessiond(&lsm, NULL);
1628}
1629
1630/*
9ae110e2
JG
1631 * Remove PID from session tracker.
1632 * Return 0 on success else a negative LTTng error code.
ccf10263
MD
1633 */
1634int lttng_untrack_pid(struct lttng_handle *handle, int pid)
1635{
1636 struct lttcomm_session_msg lsm;
1637
9ae110e2 1638 /* NULL arguments are forbidden. No default values. */
ccf10263
MD
1639 if (handle == NULL) {
1640 return -LTTNG_ERR_INVALID;
1641 }
1642
1643 memset(&lsm, 0, sizeof(lsm));
1644
1645 lsm.cmd_type = LTTNG_UNTRACK_PID;
1646 lsm.u.pid_tracker.pid = pid;
1647
1648 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
1649
1650 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
1651 sizeof(lsm.session.name));
1652
1653 return lttng_ctl_ask_sessiond(&lsm, NULL);
1654}
1655
fac6795d 1656/*
9ae110e2
JG
1657 * Lists all available tracepoints of domain.
1658 * Sets the contents of the events array.
1659 * Returns the number of lttng_event entries in events;
1660 * on error, returns a negative value.
fac6795d 1661 */
cd80958d 1662int lttng_list_tracepoints(struct lttng_handle *handle,
2a71efd5 1663 struct lttng_event **events)
fac6795d 1664{
052da939 1665 int ret;
cd80958d
DG
1666 struct lttcomm_session_msg lsm;
1667
9d697d3d 1668 if (handle == NULL) {
2f70b271 1669 return -LTTNG_ERR_INVALID;
cd80958d 1670 }
fac6795d 1671
53efb85a 1672 memset(&lsm, 0, sizeof(lsm));
cd80958d 1673 lsm.cmd_type = LTTNG_LIST_TRACEPOINTS;
cac3069d 1674 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
2a71efd5 1675
cac3069d 1676 ret = lttng_ctl_ask_sessiond(&lsm, (void **) events);
052da939
DG
1677 if (ret < 0) {
1678 return ret;
eb354453 1679 }
fac6795d 1680
9f19cc17 1681 return ret / sizeof(struct lttng_event);
fac6795d
DG
1682}
1683
f37d259d 1684/*
9ae110e2
JG
1685 * Lists all available tracepoint fields of domain.
1686 * Sets the contents of the event field array.
1687 * Returns the number of lttng_event_field entries in events;
1688 * on error, returns a negative value.
f37d259d
MD
1689 */
1690int lttng_list_tracepoint_fields(struct lttng_handle *handle,
1691 struct lttng_event_field **fields)
1692{
1693 int ret;
1694 struct lttcomm_session_msg lsm;
1695
1696 if (handle == NULL) {
2f70b271 1697 return -LTTNG_ERR_INVALID;
f37d259d
MD
1698 }
1699
53efb85a 1700 memset(&lsm, 0, sizeof(lsm));
f37d259d 1701 lsm.cmd_type = LTTNG_LIST_TRACEPOINT_FIELDS;
cac3069d 1702 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
f37d259d 1703
cac3069d 1704 ret = lttng_ctl_ask_sessiond(&lsm, (void **) fields);
f37d259d
MD
1705 if (ret < 0) {
1706 return ret;
1707 }
1708
1709 return ret / sizeof(struct lttng_event_field);
1710}
1711
834978fd 1712/*
9ae110e2
JG
1713 * Lists all available kernel system calls. Allocates and sets the contents of
1714 * the events array.
834978fd 1715 *
9ae110e2
JG
1716 * Returns the number of lttng_event entries in events; on error, returns a
1717 * negative value.
834978fd
DG
1718 */
1719int lttng_list_syscalls(struct lttng_event **events)
1720{
1721 int ret;
1722 struct lttcomm_session_msg lsm;
1723
1724 if (!events) {
1725 return -LTTNG_ERR_INVALID;
1726 }
1727
1728 memset(&lsm, 0, sizeof(lsm));
1729 lsm.cmd_type = LTTNG_LIST_SYSCALLS;
1730 /* Force kernel domain for system calls. */
1731 lsm.domain.type = LTTNG_DOMAIN_KERNEL;
1732
1733 ret = lttng_ctl_ask_sessiond(&lsm, (void **) events);
1734 if (ret < 0) {
1735 return ret;
1736 }
1737
1738 return ret / sizeof(struct lttng_event);
1739}
1740
1657e9bb 1741/*
9ae110e2
JG
1742 * Returns a human readable string describing
1743 * the error code (a negative value).
1657e9bb 1744 */
9a745bc7 1745const char *lttng_strerror(int code)
1657e9bb 1746{
f73fabfd 1747 return error_get_str(code);
1657e9bb
DG
1748}
1749
b178f53e
JG
1750enum lttng_error_code lttng_create_session_ext(
1751 struct lttng_session_descriptor *session_descriptor)
1752{
1753 enum lttng_error_code ret_code;
1754 struct lttcomm_session_msg lsm = {
1755 .cmd_type = LTTNG_CREATE_SESSION_EXT,
1756 };
1757 void *reply = NULL;
1758 struct lttng_buffer_view reply_view;
1759 int reply_ret;
1760 bool sessiond_must_generate_ouput;
1761 struct lttng_dynamic_buffer payload;
1762 int ret;
1763 size_t descriptor_size;
1764 struct lttng_session_descriptor *descriptor_reply = NULL;
1765
1766 lttng_dynamic_buffer_init(&payload);
1767 if (!session_descriptor) {
1768 ret_code = LTTNG_ERR_INVALID;
1769 goto end;
1770 }
1771
1772 sessiond_must_generate_ouput =
1773 !lttng_session_descriptor_is_output_destination_initialized(
1774 session_descriptor);
1775 if (sessiond_must_generate_ouput) {
1776 const char *home_dir = utils_get_home_dir();
1777 size_t home_dir_len = home_dir ? strlen(home_dir) + 1 : 0;
1778
1779 if (!home_dir || home_dir_len > LTTNG_PATH_MAX) {
1780 ret_code = LTTNG_ERR_FATAL;
1781 goto end;
1782 }
1783
1784 lsm.u.create_session.home_dir_size = (uint16_t) home_dir_len;
1785 ret = lttng_dynamic_buffer_append(&payload, home_dir,
1786 home_dir_len);
1787 if (ret) {
1788 ret_code = LTTNG_ERR_NOMEM;
1789 goto end;
1790 }
1791 }
1792
1793 descriptor_size = payload.size;
1794 ret = lttng_session_descriptor_serialize(session_descriptor,
1795 &payload);
1796 if (ret) {
1797 ret_code = LTTNG_ERR_INVALID;
1798 goto end;
1799 }
1800 descriptor_size = payload.size - descriptor_size;
1801 lsm.u.create_session.session_descriptor_size = descriptor_size;
1802
1803 /* Command returns a session descriptor on success. */
1804 reply_ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, payload.data,
1805 payload.size, &reply);
1806 if (reply_ret < 0) {
1807 ret_code = -reply_ret;
1808 goto end;
1809 } else if (reply_ret == 0) {
1810 /* Socket unexpectedly closed by the session daemon. */
1811 ret_code = LTTNG_ERR_FATAL;
1812 goto end;
1813 }
1814
1815 reply_view = lttng_buffer_view_init(reply, 0, reply_ret);
1816 ret = lttng_session_descriptor_create_from_buffer(&reply_view,
1817 &descriptor_reply);
1818 if (ret < 0) {
1819 ret_code = LTTNG_ERR_FATAL;
1820 goto end;
1821 }
1822 ret_code = LTTNG_OK;
1823 lttng_session_descriptor_assign(session_descriptor, descriptor_reply);
1824end:
1825 free(reply);
1826 lttng_dynamic_buffer_reset(&payload);
1827 lttng_session_descriptor_destroy(descriptor_reply);
1828 return ret_code;
1829}
1830
aaf97519 1831/*
b178f53e 1832 * Create a new session using name and url for destination.
a4b92340 1833 *
780d4bb8 1834 * Return 0 on success else a negative LTTng error code.
00e2e675 1835 */
a4b92340 1836int lttng_create_session(const char *name, const char *url)
00e2e675 1837{
3dd05a85 1838 int ret;
a4b92340 1839 ssize_t size;
a4b92340 1840 struct lttng_uri *uris = NULL;
b178f53e
JG
1841 struct lttng_session_descriptor *descriptor = NULL;
1842 enum lttng_error_code ret_code;
00e2e675 1843
b178f53e
JG
1844 if (!name) {
1845 ret = -LTTNG_ERR_INVALID;
1846 goto end;
00e2e675
DG
1847 }
1848
bc894455 1849 size = uri_parse_str_urls(url, NULL, &uris);
a4b92340 1850 if (size < 0) {
b178f53e
JG
1851 ret = -LTTNG_ERR_INVALID;
1852 goto end;
1853 }
1854 switch (size) {
1855 case 0:
1856 descriptor = lttng_session_descriptor_create(name);
1857 break;
1858 case 1:
1859 if (uris[0].dtype != LTTNG_DST_PATH) {
1860 ret = -LTTNG_ERR_INVALID;
1861 goto end;
1862 }
1863 descriptor = lttng_session_descriptor_local_create(name,
1864 uris[0].dst.path);
1865 break;
1866 case 2:
1867 descriptor = lttng_session_descriptor_network_create(name, url,
1868 NULL);
1869 break;
1870 default:
1871 ret = -LTTNG_ERR_INVALID;
1872 goto end;
1873 }
1874 if (!descriptor) {
1875 ret = -LTTNG_ERR_INVALID;
1876 goto end;
00e2e675 1877 }
b178f53e
JG
1878 ret_code = lttng_create_session_ext(descriptor);
1879 ret = ret_code == LTTNG_OK ? 0 : -ret_code;
1880end:
1881 lttng_session_descriptor_destroy(descriptor);
1882 free(uris);
1883 return ret;
1884}
00e2e675 1885
b178f53e
JG
1886/*
1887 * Create a session exclusively used for snapshot.
1888 *
780d4bb8 1889 * Return 0 on success else a negative LTTng error code.
b178f53e
JG
1890 */
1891int lttng_create_session_snapshot(const char *name, const char *snapshot_url)
1892{
1893 int ret;
1894 enum lttng_error_code ret_code;
1895 ssize_t size;
1896 struct lttng_uri *uris = NULL;
1897 struct lttng_session_descriptor *descriptor = NULL;
a4b92340 1898
b178f53e
JG
1899 if (!name) {
1900 ret = -LTTNG_ERR_INVALID;
1901 goto end;
1902 }
1903
1904 size = uri_parse_str_urls(snapshot_url, NULL, &uris);
1905 if (size < 0) {
1906 ret = -LTTNG_ERR_INVALID;
1907 goto end;
1908 }
1909 /*
1910 * If the user does not specify a custom subdir, use the session name.
1911 */
1912 if (size > 0 && uris[0].dtype != LTTNG_DST_PATH &&
1913 strlen(uris[0].subdir) == 0) {
1914 ret = snprintf(uris[0].subdir, sizeof(uris[0].subdir), "%s",
1915 name);
1916 if (ret < 0) {
1917 PERROR("Failed to set session name as network destination sub-directory");
1918 ret = -LTTNG_ERR_FATAL;
1919 goto end;
1920 } else if (ret >= sizeof(uris[0].subdir)) {
1921 /* Truncated output. */
1922 ret = -LTTNG_ERR_INVALID;
1923 goto end;
1924 }
1925 }
3dd05a85 1926
b178f53e
JG
1927 switch (size) {
1928 case 0:
1929 descriptor = lttng_session_descriptor_snapshot_create(name);
1930 break;
1931 case 1:
1932 if (uris[0].dtype != LTTNG_DST_PATH) {
1933 ret = -LTTNG_ERR_INVALID;
1934 goto end;
1935 }
1936 descriptor = lttng_session_descriptor_snapshot_local_create(
1937 name,
1938 uris[0].dst.path);
1939 break;
1940 case 2:
1941 descriptor = lttng_session_descriptor_snapshot_network_create(
1942 name,
1943 snapshot_url,
1944 NULL);
1945 break;
1946 default:
1947 ret = -LTTNG_ERR_INVALID;
1948 goto end;
1949 }
1950 if (!descriptor) {
1951 ret = -LTTNG_ERR_INVALID;
1952 goto end;
1953 }
1954 ret_code = lttng_create_session_ext(descriptor);
1955 ret = ret_code == LTTNG_OK ? 0 : -ret_code;
1956end:
1957 lttng_session_descriptor_destroy(descriptor);
3dd05a85
DG
1958 free(uris);
1959 return ret;
00e2e675
DG
1960}
1961
b178f53e
JG
1962/*
1963 * Create a session exclusively used for live.
1964 *
780d4bb8 1965 * Return 0 on success else a negative LTTng error code.
b178f53e
JG
1966 */
1967int lttng_create_session_live(const char *name, const char *url,
1968 unsigned int timer_interval)
1969{
1970 int ret;
1971 enum lttng_error_code ret_code;
1972 struct lttng_session_descriptor *descriptor = NULL;
1973
1974 if (!name) {
1975 ret = -LTTNG_ERR_INVALID;
1976 goto end;
1977 }
1978
1979 if (url) {
1980 descriptor = lttng_session_descriptor_live_network_create(
1981 name, url, NULL, timer_interval);
1982 } else {
1983 descriptor = lttng_session_descriptor_live_create(
1984 name, timer_interval);
1985 }
1986 if (!descriptor) {
1987 ret = -LTTNG_ERR_INVALID;
1988 goto end;
1989 }
1990 ret_code = lttng_create_session_ext(descriptor);
1991 ret = ret_code == LTTNG_OK ? 0 : -ret_code;
1992end:
1993 lttng_session_descriptor_destroy(descriptor);
1994 return ret;
1995}
1996
e20ee7c2
JD
1997/*
1998 * Stop the session and wait for the data before destroying it
780d4bb8
MD
1999 *
2000 * Return 0 on success else a negative LTTng error code.
e20ee7c2
JD
2001 */
2002int lttng_destroy_session(const char *session_name)
2003{
2004 int ret;
3e3665b8
JG
2005 enum lttng_error_code ret_code;
2006 enum lttng_destruction_handle_status status;
2007 struct lttng_destruction_handle *handle = NULL;
e20ee7c2
JD
2008
2009 /*
3e3665b8
JG
2010 * Stop the tracing and wait for the data to be
2011 * consumed.
e20ee7c2
JD
2012 */
2013 ret = _lttng_stop_tracing(session_name, 1);
2014 if (ret && ret != -LTTNG_ERR_TRACE_ALREADY_STOPPED) {
2015 goto end;
2016 }
2017
3e3665b8
JG
2018 ret_code = lttng_destroy_session_ext(session_name, &handle);
2019 if (ret_code != LTTNG_OK) {
2020 ret = (int) -ret_code;
2021 goto end;
2022 }
2023 assert(handle);
2024
2025 /* Block until the completion of the destruction of the session. */
2026 status = lttng_destruction_handle_wait_for_completion(handle, -1);
2027 if (status != LTTNG_DESTRUCTION_HANDLE_STATUS_COMPLETED) {
2028 ret = -LTTNG_ERR_UNK;
2029 goto end;
2030 }
2031
2032 status = lttng_destruction_handle_get_result(handle, &ret_code);
2033 if (status != LTTNG_DESTRUCTION_HANDLE_STATUS_OK) {
2034 ret = -LTTNG_ERR_UNK;
2035 goto end;
2036 }
780d4bb8 2037 ret = ret_code == LTTNG_OK ? 0 : -ret_code;
e20ee7c2 2038end:
3e3665b8 2039 lttng_destruction_handle_destroy(handle);
e20ee7c2
JD
2040 return ret;
2041}
2042
2043/*
2044 * Destroy the session without waiting for the data.
2045 */
2046int lttng_destroy_session_no_wait(const char *session_name)
2047{
3e3665b8 2048 enum lttng_error_code ret_code;
e20ee7c2 2049
3e3665b8
JG
2050 ret_code = lttng_destroy_session_ext(session_name, NULL);
2051 return ret_code == LTTNG_OK ? ret_code : -ret_code;
e20ee7c2
JD
2052}
2053
57167058 2054/*
9ae110e2
JG
2055 * Ask the session daemon for all available sessions.
2056 * Sets the contents of the sessions array.
2057 * Returns the number of lttng_session entries in sessions;
2058 * on error, returns a negative value.
57167058 2059 */
b178f53e 2060int lttng_list_sessions(struct lttng_session **out_sessions)
57167058 2061{
ca95a216 2062 int ret;
cd80958d 2063 struct lttcomm_session_msg lsm;
b178f53e
JG
2064 const size_t session_size = sizeof(struct lttng_session) +
2065 sizeof(struct lttng_session_extended);
2066 size_t session_count, i;
2067 struct lttng_session_extended *sessions_extended_begin;
2068 struct lttng_session *sessions = NULL;
57167058 2069
53efb85a 2070 memset(&lsm, 0, sizeof(lsm));
cd80958d 2071 lsm.cmd_type = LTTNG_LIST_SESSIONS;
b178f53e
JG
2072 ret = lttng_ctl_ask_sessiond(&lsm, (void**) &sessions);
2073 if (ret <= 0) {
b178f53e
JG
2074 goto end;
2075 }
2076 if (!sessions) {
2077 ret = -LTTNG_ERR_FATAL;
2078 goto end;
2079 }
2080
2081 if (ret % session_size) {
2082 ret = -LTTNG_ERR_UNK;
2083 free(sessions);
2084 *out_sessions = NULL;
2085 goto end;
57167058 2086 }
b178f53e
JG
2087 session_count = (size_t) ret / session_size;
2088 sessions_extended_begin = (struct lttng_session_extended *)
2089 (&sessions[session_count]);
57167058 2090
b178f53e
JG
2091 /* Set extended session info pointers. */
2092 for (i = 0; i < session_count; i++) {
2093 struct lttng_session *session = &sessions[i];
2094 struct lttng_session_extended *extended =
2095 &(sessions_extended_begin[i]);
2096
2097 session->extended.ptr = extended;
2098 }
2099
2100 ret = (int) session_count;
2101 *out_sessions = sessions;
2102end:
2103 return ret;
2104}
2105
2106enum lttng_error_code lttng_session_get_creation_time(
2107 const struct lttng_session *session, uint64_t *creation_time)
2108{
2109 enum lttng_error_code ret = LTTNG_OK;
2110 struct lttng_session_extended *extended;
2111
2112 if (!session || !creation_time || !session->extended.ptr) {
2113 ret = LTTNG_ERR_INVALID;
2114 goto end;
2115 }
2116
2117 extended = session->extended.ptr;
2118 if (!extended->creation_time.is_set) {
2119 /* Not created on the session daemon yet. */
2120 ret = LTTNG_ERR_SESSION_NOT_EXIST;
2121 goto end;
2122 }
2123 *creation_time = extended->creation_time.value;
2124end:
2125 return ret;
57167058
DG
2126}
2127
d7ba1388
MD
2128int lttng_set_session_shm_path(const char *session_name,
2129 const char *shm_path)
2130{
2131 struct lttcomm_session_msg lsm;
2132
2133 if (session_name == NULL) {
2134 return -LTTNG_ERR_INVALID;
2135 }
2136
2137 memset(&lsm, 0, sizeof(lsm));
2138 lsm.cmd_type = LTTNG_SET_SESSION_SHM_PATH;
2139
2140 lttng_ctl_copy_string(lsm.session.name, session_name,
2141 sizeof(lsm.session.name));
2142 lttng_ctl_copy_string(lsm.u.set_shm_path.shm_path, shm_path,
2143 sizeof(lsm.u.set_shm_path.shm_path));
2144
2145 return lttng_ctl_ask_sessiond(&lsm, NULL);
2146}
2147
9f19cc17 2148/*
9ae110e2
JG
2149 * Ask the session daemon for all available domains of a session.
2150 * Sets the contents of the domains array.
2151 * Returns the number of lttng_domain entries in domains;
2152 * on error, returns a negative value.
9f19cc17 2153 */
330be774 2154int lttng_list_domains(const char *session_name,
cd80958d 2155 struct lttng_domain **domains)
9f19cc17
DG
2156{
2157 int ret;
cd80958d
DG
2158 struct lttcomm_session_msg lsm;
2159
330be774 2160 if (session_name == NULL) {
2f70b271 2161 return -LTTNG_ERR_INVALID;
cd80958d 2162 }
9f19cc17 2163
53efb85a 2164 memset(&lsm, 0, sizeof(lsm));
cd80958d
DG
2165 lsm.cmd_type = LTTNG_LIST_DOMAINS;
2166
cac3069d
DG
2167 lttng_ctl_copy_string(lsm.session.name, session_name,
2168 sizeof(lsm.session.name));
cd80958d 2169
cac3069d 2170 ret = lttng_ctl_ask_sessiond(&lsm, (void**) domains);
9f19cc17
DG
2171 if (ret < 0) {
2172 return ret;
2173 }
2174
2175 return ret / sizeof(struct lttng_domain);
2176}
2177
2178/*
9ae110e2
JG
2179 * Ask the session daemon for all available channels of a session.
2180 * Sets the contents of the channels array.
2181 * Returns the number of lttng_channel entries in channels;
2182 * on error, returns a negative value.
9f19cc17 2183 */
cd80958d
DG
2184int lttng_list_channels(struct lttng_handle *handle,
2185 struct lttng_channel **channels)
9f19cc17
DG
2186{
2187 int ret;
53e367f9
JG
2188 size_t channel_count, i;
2189 const size_t channel_size = sizeof(struct lttng_channel) +
cf0bcb51 2190 sizeof(struct lttng_channel_extended);
cd80958d 2191 struct lttcomm_session_msg lsm;
53e367f9 2192 void *extended_at;
cd80958d 2193
9d697d3d 2194 if (handle == NULL) {
53e367f9
JG
2195 ret = -LTTNG_ERR_INVALID;
2196 goto end;
cd80958d
DG
2197 }
2198
53efb85a 2199 memset(&lsm, 0, sizeof(lsm));
cd80958d 2200 lsm.cmd_type = LTTNG_LIST_CHANNELS;
cac3069d 2201 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d 2202 sizeof(lsm.session.name));
9f19cc17 2203
cac3069d 2204 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
9f19cc17 2205
cac3069d 2206 ret = lttng_ctl_ask_sessiond(&lsm, (void**) channels);
9f19cc17 2207 if (ret < 0) {
53e367f9
JG
2208 goto end;
2209 }
2210
2211 if (ret % channel_size) {
2212 ret = -LTTNG_ERR_UNK;
2213 free(*channels);
2214 *channels = NULL;
2215 goto end;
9f19cc17 2216 }
53e367f9 2217 channel_count = (size_t) ret / channel_size;
9f19cc17 2218
53e367f9
JG
2219 /* Set extended info pointers */
2220 extended_at = ((void *) *channels) +
2221 channel_count * sizeof(struct lttng_channel);
2222 for (i = 0; i < channel_count; i++) {
2223 struct lttng_channel *chan = &(*channels)[i];
2224
2225 chan->attr.extended.ptr = extended_at;
cf0bcb51 2226 extended_at += sizeof(struct lttng_channel_extended);
53e367f9
JG
2227 }
2228
2229 ret = (int) channel_count;
2230end:
2231 return ret;
9f19cc17
DG
2232}
2233
2234/*
9ae110e2
JG
2235 * Ask the session daemon for all available events of a session channel.
2236 * Sets the contents of the events array.
2237 * Returns the number of lttng_event entries in events;
2238 * on error, returns a negative value.
9f19cc17 2239 */
cd80958d
DG
2240int lttng_list_events(struct lttng_handle *handle,
2241 const char *channel_name, struct lttng_event **events)
9f19cc17
DG
2242{
2243 int ret;
cd80958d 2244 struct lttcomm_session_msg lsm;
b4e3ceb9
PP
2245 struct lttcomm_event_command_header *cmd_header = NULL;
2246 size_t cmd_header_len;
2247 uint32_t nb_events, i;
de453daa 2248 void *comm_ext_at;
de453daa 2249 char *reception_buffer = NULL;
56f0bc67 2250 struct lttng_dynamic_buffer listing;
de453daa 2251 size_t storage_req;
9f19cc17 2252
9d697d3d
DG
2253 /* Safety check. An handle and channel name are mandatory */
2254 if (handle == NULL || channel_name == NULL) {
2f70b271 2255 return -LTTNG_ERR_INVALID;
cd80958d
DG
2256 }
2257
53efb85a 2258 memset(&lsm, 0, sizeof(lsm));
cd80958d 2259 lsm.cmd_type = LTTNG_LIST_EVENTS;
cac3069d 2260 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
cd80958d 2261 sizeof(lsm.session.name));
cac3069d 2262 lttng_ctl_copy_string(lsm.u.list.channel_name, channel_name,
cd80958d 2263 sizeof(lsm.u.list.channel_name));
cac3069d 2264 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
9f19cc17 2265
a04d53fc 2266 ret = lttng_ctl_ask_sessiond_fds_varlen(&lsm, NULL, 0, NULL, 0,
de453daa
JG
2267 (void **) &reception_buffer, (void **) &cmd_header,
2268 &cmd_header_len);
9f19cc17 2269 if (ret < 0) {
de453daa 2270 goto end;
9f19cc17
DG
2271 }
2272
d9f484bc
JG
2273 if (!cmd_header) {
2274 ret = -LTTNG_ERR_UNK;
2275 goto end;
2276 }
2277
b4e3ceb9
PP
2278 /* Set number of events and free command header */
2279 nb_events = cmd_header->nb_events;
2280 if (nb_events > INT_MAX) {
2281 ret = -EOVERFLOW;
de453daa 2282 goto end;
b4e3ceb9 2283 }
b4e3ceb9
PP
2284 free(cmd_header);
2285 cmd_header = NULL;
2286
de453daa
JG
2287 /*
2288 * The buffer that is returned must contain a "flat" version of
2289 * the events that are returned. In other words, all pointers
2290 * within an lttng_event must point to a location within the returned
56f0bc67
JG
2291 * buffer so that the user may free everything by simply calling free()
2292 * on the returned buffer. This is needed in order to maintain API
de453daa
JG
2293 * compatibility.
2294 *
56f0bc67
JG
2295 * A first pass is performed to compute the size of the buffer that
2296 * must be allocated. A second pass is then performed to setup
de453daa
JG
2297 * the returned events so that their members always point within the
2298 * buffer.
2299 *
2300 * The layout of the returned buffer is as follows:
2301 * - struct lttng_event[nb_events],
2302 * - nb_events times the following:
2303 * - struct lttng_event_extended,
2304 * - flattened version of userspace_probe_location
2305 * - filter_expression
2306 * - exclusions
2307 * - padding to align to 64-bits
2308 */
2309 comm_ext_at = reception_buffer +
2310 (nb_events * sizeof(struct lttng_event));
2311 storage_req = nb_events * sizeof(struct lttng_event);
b4e3ceb9
PP
2312
2313 for (i = 0; i < nb_events; i++) {
de453daa
JG
2314 struct lttcomm_event_extended_header *ext_comm =
2315 (struct lttcomm_event_extended_header *) comm_ext_at;
56f0bc67 2316 int probe_storage_req = 0;
b4e3ceb9 2317
de453daa
JG
2318 comm_ext_at += sizeof(*ext_comm);
2319 comm_ext_at += ext_comm->filter_len;
2320 comm_ext_at +=
2321 ext_comm->nb_exclusions * LTTNG_SYMBOL_NAME_LEN;
2322
56f0bc67
JG
2323 if (ext_comm->userspace_probe_location_len) {
2324 struct lttng_userspace_probe_location *probe_location = NULL;
2325 struct lttng_buffer_view probe_location_view;
2326
2327 probe_location_view = lttng_buffer_view_init(
2328 comm_ext_at, 0,
2329 ext_comm->userspace_probe_location_len);
2330
2331 /*
2332 * Create a temporary userspace probe location to
2333 * determine the size needed by a "flattened" version
2334 * of that same probe location.
2335 */
2336 ret = lttng_userspace_probe_location_create_from_buffer(
2337 &probe_location_view, &probe_location);
2338 if (ret < 0) {
2339 ret = -LTTNG_ERR_PROBE_LOCATION_INVAL;
2340 goto end;
2341 }
2342
2343 ret = lttng_userspace_probe_location_flatten(
2344 probe_location, NULL);
2345 lttng_userspace_probe_location_destroy(probe_location);
2346 if (ret < 0) {
2347 ret = -LTTNG_ERR_PROBE_LOCATION_INVAL;
2348 goto end;
2349 }
2350
2351 probe_storage_req = ret;
2352 comm_ext_at += ext_comm->userspace_probe_location_len;
56f0bc67
JG
2353 }
2354
de453daa 2355 storage_req += sizeof(struct lttng_event_extended);
de453daa
JG
2356 storage_req += ext_comm->filter_len;
2357 storage_req += ext_comm->nb_exclusions * LTTNG_SYMBOL_NAME_LEN;
56f0bc67
JG
2358 /* Padding to ensure the flat probe is aligned. */
2359 storage_req = ALIGN_TO(storage_req, sizeof(uint64_t));
2360 storage_req += probe_storage_req;
b4e3ceb9
PP
2361 }
2362
56f0bc67
JG
2363 lttng_dynamic_buffer_init(&listing);
2364 /*
2365 * We must ensure that "listing" is never resized so as to preserve
2366 * the validity of the flattened objects.
2367 */
2368 ret = lttng_dynamic_buffer_set_capacity(&listing, storage_req);
2369 if (ret) {
2370 ret = -LTTNG_ERR_NOMEM;
de453daa
JG
2371 goto end;
2372 }
56f0bc67
JG
2373
2374 ret = lttng_dynamic_buffer_append(&listing, reception_buffer,
2375 nb_events * sizeof(struct lttng_event));
2376 if (ret) {
2377 ret = -LTTNG_ERR_NOMEM;
2378 goto free_dynamic_buffer;
2379 }
de453daa
JG
2380
2381 comm_ext_at = reception_buffer +
56f0bc67 2382 (nb_events * sizeof(struct lttng_event));
de453daa
JG
2383 for (i = 0; i < nb_events; i++) {
2384 struct lttng_event *event = (struct lttng_event *)
56f0bc67 2385 (listing.data + (sizeof(struct lttng_event) * i));
de453daa
JG
2386 struct lttcomm_event_extended_header *ext_comm =
2387 (struct lttcomm_event_extended_header *) comm_ext_at;
2388 struct lttng_event_extended *event_extended =
56f0bc67
JG
2389 (struct lttng_event_extended *)
2390 (listing.data + listing.size);
de453daa 2391
56f0bc67
JG
2392 /* Insert struct lttng_event_extended. */
2393 ret = lttng_dynamic_buffer_set_size(&listing,
2394 listing.size + sizeof(*event_extended));
2395 if (ret) {
2396 ret = -LTTNG_ERR_NOMEM;
2397 goto free_dynamic_buffer;
2398 }
de453daa 2399 event->extended.ptr = event_extended;
56f0bc67 2400
de453daa
JG
2401 comm_ext_at += sizeof(*ext_comm);
2402
56f0bc67
JG
2403 /* Insert filter expression. */
2404 if (ext_comm->filter_len) {
2405 event_extended->filter_expression = listing.data +
2406 listing.size;
2407 ret = lttng_dynamic_buffer_append(&listing, comm_ext_at,
2408 ext_comm->filter_len);
2409 if (ret) {
2410 ret = -LTTNG_ERR_NOMEM;
2411 goto free_dynamic_buffer;
2412 }
2413 comm_ext_at += ext_comm->filter_len;
2414 }
2415
2416 /* Insert exclusions. */
2417 if (ext_comm->nb_exclusions) {
2418 event_extended->exclusions.count =
2419 ext_comm->nb_exclusions;
2420 event_extended->exclusions.strings =
2421 listing.data + listing.size;
2422
2423 ret = lttng_dynamic_buffer_append(&listing,
2424 comm_ext_at,
2425 ext_comm->nb_exclusions * LTTNG_SYMBOL_NAME_LEN);
2426 if (ret) {
2427 ret = -LTTNG_ERR_NOMEM;
5e4f4898 2428 goto free_dynamic_buffer;
56f0bc67
JG
2429 }
2430 comm_ext_at += ext_comm->nb_exclusions * LTTNG_SYMBOL_NAME_LEN;
2431 }
2432
2433 /* Insert padding to align to 64-bits. */
2434 ret = lttng_dynamic_buffer_set_size(&listing,
2435 ALIGN_TO(listing.size, sizeof(uint64_t)));
2436 if (ret) {
2437 ret = -LTTNG_ERR_NOMEM;
2438 goto free_dynamic_buffer;
2439 }
2440
2441 /* Insert flattened userspace probe location. */
2442 if (ext_comm->userspace_probe_location_len) {
2443 struct lttng_userspace_probe_location *probe_location = NULL;
2444 struct lttng_buffer_view probe_location_view;
de453daa 2445
56f0bc67
JG
2446 probe_location_view = lttng_buffer_view_init(
2447 comm_ext_at, 0,
2448 ext_comm->userspace_probe_location_len);
de453daa 2449
56f0bc67
JG
2450 ret = lttng_userspace_probe_location_create_from_buffer(
2451 &probe_location_view, &probe_location);
2452 if (ret < 0) {
2453 ret = -LTTNG_ERR_PROBE_LOCATION_INVAL;
2454 goto free_dynamic_buffer;
2455 }
2456
2457 event_extended->probe_location = (struct lttng_userspace_probe_location *)
2458 (listing.data + listing.size);
2459 ret = lttng_userspace_probe_location_flatten(
2460 probe_location, &listing);
2461 lttng_userspace_probe_location_destroy(probe_location);
2462 if (ret < 0) {
2463 ret = -LTTNG_ERR_PROBE_LOCATION_INVAL;
2464 goto free_dynamic_buffer;
2465 }
2466
2467 comm_ext_at += ext_comm->userspace_probe_location_len;
2468 }
de453daa
JG
2469 }
2470
56f0bc67
JG
2471 /* Don't reset listing buffer as we return its content. */
2472 *events = (struct lttng_event *) listing.data;
2473 lttng_dynamic_buffer_init(&listing);
de453daa 2474 ret = (int) nb_events;
56f0bc67
JG
2475free_dynamic_buffer:
2476 lttng_dynamic_buffer_reset(&listing);
de453daa 2477end:
b4e3ceb9 2478 free(cmd_header);
de453daa 2479 free(reception_buffer);
b4e3ceb9 2480 return ret;
9f19cc17
DG
2481}
2482
fac6795d 2483/*
1c8d13c8
TD
2484 * Sets the tracing_group variable with name.
2485 * This function allocates memory pointed to by tracing_group.
2486 * On success, returns 0, on error, returns -1 (null name) or -ENOMEM.
fac6795d
DG
2487 */
2488int lttng_set_tracing_group(const char *name)
2489{
9d697d3d 2490 if (name == NULL) {
2f70b271 2491 return -LTTNG_ERR_INVALID;
9d697d3d
DG
2492 }
2493
fac6795d 2494 if (asprintf(&tracing_group, "%s", name) < 0) {
2f70b271 2495 return -LTTNG_ERR_FATAL;
fac6795d
DG
2496 }
2497
2498 return 0;
2499}
2500
cd80958d 2501int lttng_calibrate(struct lttng_handle *handle,
d0254c7c
MD
2502 struct lttng_calibrate *calibrate)
2503{
b812e5ca
PP
2504 /*
2505 * This command was removed in LTTng 2.9.
2506 */
2507 return -LTTNG_ERR_UND;
d0254c7c
MD
2508}
2509
5edd7e09
DG
2510/*
2511 * Set default channel attributes.
441c16a7 2512 * If either or both of the arguments are null, attr content is zeroe'd.
5edd7e09
DG
2513 */
2514void lttng_channel_set_default_attr(struct lttng_domain *domain,
2515 struct lttng_channel_attr *attr)
2516{
294851b0 2517 struct lttng_channel_extended *extended;
cf0bcb51 2518
5edd7e09
DG
2519 /* Safety check */
2520 if (attr == NULL || domain == NULL) {
2521 return;
2522 }
2523
294851b0 2524 extended = (struct lttng_channel_extended *) attr->extended.ptr;
eacaa7a6
DS
2525 memset(attr, 0, sizeof(struct lttng_channel_attr));
2526
0a9c6494
DG
2527 /* Same for all domains. */
2528 attr->overwrite = DEFAULT_CHANNEL_OVERWRITE;
2529 attr->tracefile_size = DEFAULT_CHANNEL_TRACEFILE_SIZE;
2530 attr->tracefile_count = DEFAULT_CHANNEL_TRACEFILE_COUNT;
2531
5edd7e09
DG
2532 switch (domain->type) {
2533 case LTTNG_DOMAIN_KERNEL:
9ae110e2
JG
2534 attr->switch_timer_interval =
2535 DEFAULT_KERNEL_CHANNEL_SWITCH_TIMER;
d92ff3ef 2536 attr->read_timer_interval = DEFAULT_KERNEL_CHANNEL_READ_TIMER;
3e230f92 2537 attr->subbuf_size = default_get_kernel_channel_subbuf_size();
5edd7e09
DG
2538 attr->num_subbuf = DEFAULT_KERNEL_CHANNEL_SUBBUF_NUM;
2539 attr->output = DEFAULT_KERNEL_CHANNEL_OUTPUT;
cf0bcb51
JG
2540 if (extended) {
2541 extended->monitor_timer_interval =
2542 DEFAULT_KERNEL_CHANNEL_MONITOR_TIMER;
491d1539
MD
2543 extended->blocking_timeout =
2544 DEFAULT_KERNEL_CHANNEL_BLOCKING_TIMEOUT;
cf0bcb51 2545 }
5edd7e09
DG
2546 break;
2547 case LTTNG_DOMAIN_UST:
0a9c6494
DG
2548 switch (domain->buf_type) {
2549 case LTTNG_BUFFER_PER_UID:
2550 attr->subbuf_size = default_get_ust_uid_channel_subbuf_size();
2551 attr->num_subbuf = DEFAULT_UST_UID_CHANNEL_SUBBUF_NUM;
2552 attr->output = DEFAULT_UST_UID_CHANNEL_OUTPUT;
9ae110e2
JG
2553 attr->switch_timer_interval =
2554 DEFAULT_UST_UID_CHANNEL_SWITCH_TIMER;
2555 attr->read_timer_interval =
2556 DEFAULT_UST_UID_CHANNEL_READ_TIMER;
cf0bcb51
JG
2557 if (extended) {
2558 extended->monitor_timer_interval =
2559 DEFAULT_UST_UID_CHANNEL_MONITOR_TIMER;
491d1539
MD
2560 extended->blocking_timeout =
2561 DEFAULT_UST_UID_CHANNEL_BLOCKING_TIMEOUT;
cf0bcb51 2562 }
0a9c6494
DG
2563 break;
2564 case LTTNG_BUFFER_PER_PID:
2565 default:
2566 attr->subbuf_size = default_get_ust_pid_channel_subbuf_size();
2567 attr->num_subbuf = DEFAULT_UST_PID_CHANNEL_SUBBUF_NUM;
2568 attr->output = DEFAULT_UST_PID_CHANNEL_OUTPUT;
9ae110e2
JG
2569 attr->switch_timer_interval =
2570 DEFAULT_UST_PID_CHANNEL_SWITCH_TIMER;
2571 attr->read_timer_interval =
2572 DEFAULT_UST_PID_CHANNEL_READ_TIMER;
cf0bcb51
JG
2573 if (extended) {
2574 extended->monitor_timer_interval =
2575 DEFAULT_UST_PID_CHANNEL_MONITOR_TIMER;
491d1539
MD
2576 extended->blocking_timeout =
2577 DEFAULT_UST_PID_CHANNEL_BLOCKING_TIMEOUT;
cf0bcb51 2578 }
0a9c6494
DG
2579 break;
2580 }
5edd7e09 2581 default:
441c16a7 2582 /* Default behavior: leave set to 0. */
5edd7e09
DG
2583 break;
2584 }
cf0bcb51
JG
2585
2586 attr->extended.ptr = extended;
5edd7e09
DG
2587}
2588
5ba3702f
JG
2589int lttng_channel_get_discarded_event_count(struct lttng_channel *channel,
2590 uint64_t *discarded_events)
2591{
2592 int ret = 0;
cf0bcb51 2593 struct lttng_channel_extended *chan_ext;
5ba3702f
JG
2594
2595 if (!channel || !discarded_events) {
2596 ret = -LTTNG_ERR_INVALID;
2597 goto end;
2598 }
2599
2600 chan_ext = channel->attr.extended.ptr;
2601 if (!chan_ext) {
2602 /*
2603 * This can happen since the lttng_channel structure is
2604 * used for other tasks where this pointer is never set.
2605 */
2606 *discarded_events = 0;
2607 goto end;
2608 }
2609
2610 *discarded_events = chan_ext->discarded_events;
2611end:
2612 return ret;
2613}
2614
2615int lttng_channel_get_lost_packet_count(struct lttng_channel *channel,
2616 uint64_t *lost_packets)
2617{
2618 int ret = 0;
cf0bcb51 2619 struct lttng_channel_extended *chan_ext;
5ba3702f
JG
2620
2621 if (!channel || !lost_packets) {
2622 ret = -LTTNG_ERR_INVALID;
2623 goto end;
2624 }
2625
2626 chan_ext = channel->attr.extended.ptr;
2627 if (!chan_ext) {
2628 /*
2629 * This can happen since the lttng_channel structure is
2630 * used for other tasks where this pointer is never set.
2631 */
2632 *lost_packets = 0;
2633 goto end;
2634 }
2635
2636 *lost_packets = chan_ext->lost_packets;
2637end:
2638 return ret;
2639}
2640
cf0bcb51
JG
2641int lttng_channel_get_monitor_timer_interval(struct lttng_channel *chan,
2642 uint64_t *monitor_timer_interval)
2643{
2644 int ret = 0;
2645
2646 if (!chan || !monitor_timer_interval) {
2647 ret = -LTTNG_ERR_INVALID;
2648 goto end;
2649 }
2650
2651 if (!chan->attr.extended.ptr) {
2652 ret = -LTTNG_ERR_INVALID;
2653 goto end;
2654 }
2655
2656 *monitor_timer_interval = ((struct lttng_channel_extended *)
2657 chan->attr.extended.ptr)->monitor_timer_interval;
2658end:
2659 return ret;
2660}
2661
2662int lttng_channel_set_monitor_timer_interval(struct lttng_channel *chan,
2663 uint64_t monitor_timer_interval)
2664{
2665 int ret = 0;
2666
2667 if (!chan || !chan->attr.extended.ptr) {
2668 ret = -LTTNG_ERR_INVALID;
2669 goto end;
2670 }
2671
2672 ((struct lttng_channel_extended *)
2673 chan->attr.extended.ptr)->monitor_timer_interval =
2674 monitor_timer_interval;
2675end:
2676 return ret;
2677}
2678
491d1539
MD
2679int lttng_channel_get_blocking_timeout(struct lttng_channel *chan,
2680 int64_t *blocking_timeout)
2681{
2682 int ret = 0;
2683
2684 if (!chan || !blocking_timeout) {
2685 ret = -LTTNG_ERR_INVALID;
2686 goto end;
2687 }
2688
2689 if (!chan->attr.extended.ptr) {
2690 ret = -LTTNG_ERR_INVALID;
2691 goto end;
2692 }
2693
2694 *blocking_timeout = ((struct lttng_channel_extended *)
2695 chan->attr.extended.ptr)->blocking_timeout;
2696end:
2697 return ret;
2698}
2699
2700int lttng_channel_set_blocking_timeout(struct lttng_channel *chan,
2701 int64_t blocking_timeout)
2702{
2703 int ret = 0;
2704 int64_t msec_timeout;
2705
2706 if (!chan || !chan->attr.extended.ptr) {
2707 ret = -LTTNG_ERR_INVALID;
2708 goto end;
2709 }
2710
2711 if (blocking_timeout < 0 && blocking_timeout != -1) {
2712 ret = -LTTNG_ERR_INVALID;
2713 goto end;
2714 }
2715
2716 /*
2717 * LTTng-ust's use of poll() to implement this timeout mechanism forces
2718 * us to accept a narrower range of values (msecs expressed as a signed
2719 * 32-bit integer).
2720 */
2721 msec_timeout = blocking_timeout / 1000;
2722 if (msec_timeout != (int32_t) msec_timeout) {
2723 ret = -LTTNG_ERR_INVALID;
2724 goto end;
2725 }
2726
2727 ((struct lttng_channel_extended *)
2728 chan->attr.extended.ptr)->blocking_timeout =
2729 blocking_timeout;
2730end:
2731 return ret;
2732}
2733
fac6795d 2734/*
2269e89e 2735 * Check if session daemon is alive.
fac6795d 2736 *
2269e89e 2737 * Return 1 if alive or 0 if not.
1c8d13c8 2738 * On error returns a negative value.
fac6795d 2739 */
947308c4 2740int lttng_session_daemon_alive(void)
fac6795d
DG
2741{
2742 int ret;
2743
2744 ret = set_session_daemon_path();
2745 if (ret < 0) {
9ae110e2 2746 /* Error. */
fac6795d
DG
2747 return ret;
2748 }
2749
9d035200 2750 if (*sessiond_sock_path == '\0') {
2f70b271 2751 /*
9ae110e2
JG
2752 * No socket path set. Weird error which means the constructor
2753 * was not called.
2f70b271
DG
2754 */
2755 assert(0);
fac6795d
DG
2756 }
2757
2269e89e 2758 ret = try_connect_sessiond(sessiond_sock_path);
7d8234d9 2759 if (ret < 0) {
9ae110e2 2760 /* Not alive. */
7d8234d9
MD
2761 return 0;
2762 }
7d8234d9 2763
9ae110e2 2764 /* Is alive. */
947308c4 2765 return 1;
fac6795d
DG
2766}
2767
00e2e675 2768/*
a4b92340 2769 * Set URL for a consumer for a session and domain.
00e2e675
DG
2770 *
2771 * Return 0 on success, else a negative value.
2772 */
a4b92340
DG
2773int lttng_set_consumer_url(struct lttng_handle *handle,
2774 const char *control_url, const char *data_url)
00e2e675 2775{
3dd05a85 2776 int ret;
a4b92340 2777 ssize_t size;
00e2e675 2778 struct lttcomm_session_msg lsm;
a4b92340 2779 struct lttng_uri *uris = NULL;
00e2e675 2780
a4b92340 2781 if (handle == NULL || (control_url == NULL && data_url == NULL)) {
2f70b271 2782 return -LTTNG_ERR_INVALID;
00e2e675
DG
2783 }
2784
a4b92340
DG
2785 memset(&lsm, 0, sizeof(lsm));
2786
00e2e675
DG
2787 lsm.cmd_type = LTTNG_SET_CONSUMER_URI;
2788
cac3069d 2789 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
00e2e675 2790 sizeof(lsm.session.name));
cac3069d 2791 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
00e2e675 2792
bc894455 2793 size = uri_parse_str_urls(control_url, data_url, &uris);
a4b92340 2794 if (size < 0) {
2f70b271 2795 return -LTTNG_ERR_INVALID;
a4b92340
DG
2796 }
2797
2798 lsm.u.uri.size = size;
00e2e675 2799
795a978d 2800 ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, uris,
cac3069d 2801 sizeof(struct lttng_uri) * size, NULL);
3dd05a85
DG
2802
2803 free(uris);
2804 return ret;
00e2e675
DG
2805}
2806
2807/*
9c6bda17 2808 * [OBSOLETE]
00e2e675
DG
2809 */
2810int lttng_enable_consumer(struct lttng_handle *handle)
2811{
785d2d0d 2812 return -ENOSYS;
00e2e675
DG
2813}
2814
2815/*
9c6bda17 2816 * [OBSOLETE]
00e2e675
DG
2817 */
2818int lttng_disable_consumer(struct lttng_handle *handle)
2819{
785d2d0d 2820 return -ENOSYS;
00e2e675
DG
2821}
2822
07424f16 2823/*
b178f53e 2824 * [OBSOLETE]
07424f16
DG
2825 */
2826int _lttng_create_session_ext(const char *name, const char *url,
2827 const char *datetime)
2828{
b178f53e 2829 return -ENOSYS;
07424f16
DG
2830}
2831
806e2684
DG
2832/*
2833 * For a given session name, this call checks if the data is ready to be read
2834 * or is still being extracted by the consumer(s) hence not ready to be used by
2835 * any readers.
2836 */
6d805429 2837int lttng_data_pending(const char *session_name)
806e2684
DG
2838{
2839 int ret;
2840 struct lttcomm_session_msg lsm;
f6151c55 2841 uint8_t *pending = NULL;
806e2684
DG
2842
2843 if (session_name == NULL) {
2844 return -LTTNG_ERR_INVALID;
2845 }
2846
53efb85a 2847 memset(&lsm, 0, sizeof(lsm));
6d805429 2848 lsm.cmd_type = LTTNG_DATA_PENDING;
806e2684 2849
cac3069d
DG
2850 lttng_ctl_copy_string(lsm.session.name, session_name,
2851 sizeof(lsm.session.name));
806e2684 2852
f6151c55
JG
2853 ret = lttng_ctl_ask_sessiond(&lsm, (void **) &pending);
2854 if (ret < 0) {
2855 goto end;
2856 } else if (ret != 1) {
2857 /* Unexpected payload size */
2858 ret = -LTTNG_ERR_INVALID;
2859 goto end;
e848d36d
JG
2860 } else if (!pending) {
2861 /* Internal error. */
2862 ret = -LTTNG_ERR_UNK;
2863 goto end;
806e2684
DG
2864 }
2865
f6151c55
JG
2866 ret = (int) *pending;
2867end:
2868 free(pending);
806e2684
DG
2869 return ret;
2870}
2871
a5dfbb9d
MD
2872/*
2873 * List PIDs in the tracker.
2874 *
1b18ce93
JG
2875 * enabled is set to whether the PID tracker is enabled.
2876 * pids is set to an allocated array of PIDs currently tracked. On
2877 * success, pids must be freed by the caller.
2878 * nr_pids is set to the number of entries contained by the pids array.
a5dfbb9d
MD
2879 *
2880 * Returns 0 on success, else a negative LTTng error code.
2881 */
2882int lttng_list_tracker_pids(struct lttng_handle *handle,
2883 int *_enabled, int32_t **_pids, size_t *_nr_pids)
2884{
ebbf5ab7
JR
2885 int ret;
2886 int enabled = 1;
a5dfbb9d
MD
2887 struct lttcomm_session_msg lsm;
2888 size_t nr_pids;
ff75c11e 2889 int32_t *pids = NULL;
a5dfbb9d
MD
2890
2891 if (handle == NULL) {
2892 return -LTTNG_ERR_INVALID;
2893 }
2894
2895 memset(&lsm, 0, sizeof(lsm));
2896 lsm.cmd_type = LTTNG_LIST_TRACKER_PIDS;
2897 lttng_ctl_copy_string(lsm.session.name, handle->session_name,
2898 sizeof(lsm.session.name));
2899 lttng_ctl_copy_lttng_domain(&lsm.domain, &handle->domain);
2900
2901 ret = lttng_ctl_ask_sessiond(&lsm, (void **) &pids);
2902 if (ret < 0) {
2903 return ret;
2904 }
2905 nr_pids = ret / sizeof(int32_t);
de8218d4
JG
2906 if (nr_pids > 0 && !pids) {
2907 return -LTTNG_ERR_UNK;
2908 }
a5dfbb9d
MD
2909 if (nr_pids == 1 && pids[0] == -1) {
2910 free(pids);
2911 pids = NULL;
2912 enabled = 0;
2913 nr_pids = 0;
2914 }
2915 *_enabled = enabled;
2916 *_pids = pids;
2917 *_nr_pids = nr_pids;
2918 return 0;
2919}
2920
93ec662e
JD
2921/*
2922 * Regenerate the metadata for a session.
2923 * Return 0 on success, a negative error code on error.
2924 */
eded6438 2925int lttng_regenerate_metadata(const char *session_name)
93ec662e
JD
2926{
2927 int ret;
2928 struct lttcomm_session_msg lsm;
2929
2930 if (!session_name) {
2931 ret = -LTTNG_ERR_INVALID;
2932 goto end;
2933 }
2934
2935 memset(&lsm, 0, sizeof(lsm));
eded6438 2936 lsm.cmd_type = LTTNG_REGENERATE_METADATA;
93ec662e
JD
2937
2938 lttng_ctl_copy_string(lsm.session.name, session_name,
2939 sizeof(lsm.session.name));
2940
2941 ret = lttng_ctl_ask_sessiond(&lsm, NULL);
2942 if (ret < 0) {
2943 goto end;
2944 }
2945
2946 ret = 0;
2947end:
2948 return ret;
2949}
2950
eded6438
JD
2951/*
2952 * Deprecated, replaced by lttng_regenerate_metadata.
2953 */
2954int lttng_metadata_regenerate(const char *session_name)
2955{
2956 return lttng_regenerate_metadata(session_name);
2957}
2958
c2561365
JD
2959/*
2960 * Regenerate the statedump of a session.
2961 * Return 0 on success, a negative error code on error.
2962 */
2963int lttng_regenerate_statedump(const char *session_name)
2964{
2965 int ret;
2966 struct lttcomm_session_msg lsm;
2967
2968 if (!session_name) {
2969 ret = -LTTNG_ERR_INVALID;
2970 goto end;
2971 }
2972
2973 memset(&lsm, 0, sizeof(lsm));
2974 lsm.cmd_type = LTTNG_REGENERATE_STATEDUMP;
2975
2976 lttng_ctl_copy_string(lsm.session.name, session_name,
2977 sizeof(lsm.session.name));
2978
2979 ret = lttng_ctl_ask_sessiond(&lsm, NULL);
2980 if (ret < 0) {
2981 goto end;
2982 }
2983
2984 ret = 0;
2985end:
2986 return ret;
2987}
2988
a58c490f
JG
2989int lttng_register_trigger(struct lttng_trigger *trigger)
2990{
2991 int ret;
2992 struct lttcomm_session_msg lsm;
3647288f 2993 struct lttng_dynamic_buffer buffer;
a58c490f 2994
3647288f 2995 lttng_dynamic_buffer_init(&buffer);
a58c490f
JG
2996 if (!trigger) {
2997 ret = -LTTNG_ERR_INVALID;
2998 goto end;
2999 }
3000
3001 if (!lttng_trigger_validate(trigger)) {
eac4828d 3002 ret = -LTTNG_ERR_INVALID_TRIGGER;
a58c490f
JG
3003 goto end;
3004 }
3005
3647288f
JG
3006 ret = lttng_trigger_serialize(trigger, &buffer);
3007 if (ret < 0) {
a58c490f
JG
3008 ret = -LTTNG_ERR_UNK;
3009 goto end;
3010 }
3011
a58c490f
JG
3012 memset(&lsm, 0, sizeof(lsm));
3013 lsm.cmd_type = LTTNG_REGISTER_TRIGGER;
3647288f
JG
3014 lsm.u.trigger.length = (uint32_t) buffer.size;
3015 ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, buffer.data,
3016 buffer.size, NULL);
a58c490f 3017end:
3647288f 3018 lttng_dynamic_buffer_reset(&buffer);
a58c490f
JG
3019 return ret;
3020}
3021
3022int lttng_unregister_trigger(struct lttng_trigger *trigger)
3023{
3024 int ret;
3025 struct lttcomm_session_msg lsm;
3647288f 3026 struct lttng_dynamic_buffer buffer;
a58c490f 3027
3647288f 3028 lttng_dynamic_buffer_init(&buffer);
a58c490f
JG
3029 if (!trigger) {
3030 ret = -LTTNG_ERR_INVALID;
3031 goto end;
3032 }
3033
3034 if (!lttng_trigger_validate(trigger)) {
3647288f 3035 ret = -LTTNG_ERR_INVALID_TRIGGER;
a58c490f
JG
3036 goto end;
3037 }
3038
3647288f
JG
3039 ret = lttng_trigger_serialize(trigger, &buffer);
3040 if (ret < 0) {
a58c490f
JG
3041 ret = -LTTNG_ERR_UNK;
3042 goto end;
3043 }
3044
a58c490f
JG
3045 memset(&lsm, 0, sizeof(lsm));
3046 lsm.cmd_type = LTTNG_UNREGISTER_TRIGGER;
3647288f
JG
3047 lsm.u.trigger.length = (uint32_t) buffer.size;
3048 ret = lttng_ctl_ask_sessiond_varlen_no_cmd_header(&lsm, buffer.data,
3049 buffer.size, NULL);
a58c490f 3050end:
3647288f 3051 lttng_dynamic_buffer_reset(&buffer);
a58c490f
JG
3052 return ret;
3053}
3054
fac6795d 3055/*
9ae110e2 3056 * lib constructor.
fac6795d 3057 */
b2b89e8a 3058static void __attribute__((constructor)) init(void)
fac6795d
DG
3059{
3060 /* Set default session group */
bbccc3d2 3061 lttng_set_tracing_group(DEFAULT_TRACING_GROUP);
fac6795d 3062}
49cca668
DG
3063
3064/*
9ae110e2 3065 * lib destructor.
49cca668 3066 */
b2b89e8a 3067static void __attribute__((destructor)) lttng_ctl_exit(void)
49cca668
DG
3068{
3069 free(tracing_group);
3070}
This page took 0.376191 seconds and 4 git commands to generate.