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