Mi: track/untrack/listing
[lttng-tools.git] / src / bin / lttng / commands / track-untrack.c
1 /*
2 * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
3 * Copyright (C) 2015 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License, version 2 only,
7 * as published by the Free Software Foundation.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License along
15 * with this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
17 */
18
19 #define _GNU_SOURCE
20 #define _LGPL_SOURCE
21 #include <ctype.h>
22 #include <popt.h>
23 #include <stdio.h>
24 #include <stdlib.h>
25 #include <string.h>
26 #include <sys/stat.h>
27 #include <sys/types.h>
28 #include <unistd.h>
29
30 #include <urcu/list.h>
31
32 #include <common/mi-lttng.h>
33
34 #include "../command.h"
35
36 enum cmd_type {
37 CMD_TRACK,
38 CMD_UNTRACK,
39 };
40
41 static char *opt_session_name;
42 static int opt_kernel;
43 static int opt_userspace;
44 static int opt_all;
45 static char *opt_pid_string;
46 static int opt_pid;
47
48 enum {
49 OPT_HELP = 1,
50 OPT_LIST_OPTIONS,
51 OPT_SESSION,
52 OPT_PID,
53 };
54
55 static struct poptOption long_options[] = {
56 /* { longName, shortName, argInfo, argPtr, value, descrip, argDesc, } */
57 { "help", 'h', POPT_ARG_NONE, 0, OPT_HELP, 0, 0, },
58 { "session", 's', POPT_ARG_STRING, &opt_session_name, OPT_SESSION, 0, 0, },
59 { "kernel", 'k', POPT_ARG_VAL, &opt_kernel, 1, 0, 0, },
60 { "userspace", 'u', POPT_ARG_VAL, &opt_userspace, 1, 0, 0, },
61 { "pid", 'p', POPT_ARG_STRING | POPT_ARGFLAG_OPTIONAL, &opt_pid_string, OPT_PID, 0, 0, },
62 { "all", 'a', POPT_ARG_VAL, &opt_all, 1, 0, 0, },
63 { "list-options", 0, POPT_ARG_NONE, NULL, OPT_LIST_OPTIONS, 0, 0, },
64 { 0, 0, 0, 0, 0, 0, 0, },
65 };
66
67 /*
68 * usage
69 */
70 static void usage(FILE *ofp, const char *cmd_str)
71 {
72 fprintf(ofp, "usage: lttng %s [-k|-u] [OPTIONS]\n", cmd_str);
73 fprintf(ofp, "\n");
74 fprintf(ofp, "If no session is given (-s), the context is added to\n");
75 fprintf(ofp, "the current sesssion. Exactly one domain (-k or -u)\n");
76 fprintf(ofp, "must be specified.\n");
77 fprintf(ofp, "\n");
78 fprintf(ofp, "Options:\n");
79 fprintf(ofp, " -h, --help Show this help.\n");
80 fprintf(ofp, " --list-options Simple listing of options.\n");
81 fprintf(ofp, " -s, --session NAME Apply to session name.\n");
82 fprintf(ofp, " -k, --kernel Apply to the kernel tracer.\n");
83 fprintf(ofp, " -u, --userspace Apply to the user-space tracer.\n");
84 fprintf(ofp, " -p, --pid [PID] Process ID tracker. Leave PID empty when used with --all.\n");
85 fprintf(ofp, " -a, --all All PIDs (use with --pid).\n");
86 fprintf(ofp, "\n");
87 }
88
89 static
90 int parse_pid_string(const char *_pid_string,
91 int all, int **_pid_list, int *nr_pids)
92 {
93 const char *one_pid_str;
94 char *iter;
95 int retval = CMD_SUCCESS;
96 int count = 0;
97 int *pid_list = NULL;
98 char *pid_string = NULL;
99 char *endptr;
100
101 if (all && _pid_string) {
102 ERR("An empty PID string is expected with --all");
103 retval = CMD_ERROR;
104 goto error;
105 }
106 if (!all && !_pid_string) {
107 ERR("Please specify --all with an empty PID string");
108 retval = CMD_ERROR;
109 goto error;
110 }
111 if (all) {
112 pid_list = zmalloc(sizeof(*_pid_list));
113 if (!pid_list) {
114 ERR("Out of memory");
115 retval = CMD_ERROR;
116 goto error;
117 }
118 /* Empty PID string means all PIDs */
119 count = 1;
120 pid_list[0] = -1;
121 goto assign;
122 }
123
124 pid_string = strdup(_pid_string);
125 if (!pid_string) {
126 ERR("Out of memory");
127 retval = CMD_ERROR;
128 goto error;
129 }
130
131 /* Count */
132 one_pid_str = strtok_r(pid_string, ",", &iter);
133 while (one_pid_str != NULL) {
134 unsigned long v;
135
136 errno = 0;
137 v = strtoul(one_pid_str, &endptr, 10);
138 if ((v == 0 && errno == EINVAL)
139 || (v == ULONG_MAX && errno == ERANGE)
140 || (*one_pid_str != '\0' && *endptr != '\0')){
141 ERR("Error parsing PID %s", one_pid_str);
142 retval = CMD_ERROR;
143 goto error;
144 }
145
146 if ((long) v > INT_MAX || (int) v < 0) {
147 ERR("Invalid PID value %ld", (long) v);
148 retval = CMD_ERROR;
149 goto error;
150 }
151 count++;
152
153 /* For next loop */
154 one_pid_str = strtok_r(NULL, ",", &iter);
155 }
156
157 free(pid_string);
158 /* Identity of delimiter has been lost in first pass. */
159 pid_string = strdup(_pid_string);
160 if (!pid_string) {
161 ERR("Out of memory");
162 retval = CMD_ERROR;
163 goto error;
164 }
165
166 /* Allocate */
167 pid_list = zmalloc(count * sizeof(*pid_list));
168 if (!pid_list) {
169 ERR("Out of memory");
170 retval = CMD_ERROR;
171 goto error;
172 }
173
174 /* Copy */
175 count = 0;
176 one_pid_str = strtok_r(pid_string, ",", &iter);
177 while (one_pid_str != NULL) {
178 unsigned long v;
179
180 v = strtoul(one_pid_str, NULL, 10);
181 pid_list[count++] = (int) v;
182
183 /* For next loop */
184 one_pid_str = strtok_r(NULL, ",", &iter);
185 }
186
187 assign:
188 *nr_pids = count;
189 *_pid_list = pid_list;
190 goto end; /* SUCCESS */
191
192 /* ERROR */
193 error:
194 free(pid_list);
195 end:
196 free(pid_string);
197 return retval;
198 }
199
200 static
201 int track_untrack_pid(enum cmd_type cmd_type, const char *cmd_str,
202 const char *session_name, const char *pid_string,
203 int all, struct mi_writer *writer)
204 {
205 int ret, retval = CMD_SUCCESS, success = 1 , i;
206 int *pid_list = NULL;
207 int nr_pids;
208 struct lttng_domain dom;
209 struct lttng_handle *handle = NULL;
210 int (*lib_func)(struct lttng_handle *handle, int pid);
211
212 switch (cmd_type) {
213 case CMD_TRACK:
214 lib_func = lttng_track_pid;
215 break;
216 case CMD_UNTRACK:
217 lib_func = lttng_untrack_pid;
218 break;
219 default:
220 ERR("Unknown command");
221 retval = CMD_ERROR;
222 goto end;
223 }
224
225 memset(&dom, 0, sizeof(dom));
226 if (opt_kernel) {
227 dom.type = LTTNG_DOMAIN_KERNEL;
228 } else if (opt_userspace) {
229 dom.type = LTTNG_DOMAIN_UST;
230 } else {
231 print_missing_domain();
232 ret = CMD_ERROR;
233 goto end;
234 }
235
236 ret = parse_pid_string(pid_string, all, &pid_list, &nr_pids);
237 if (ret != CMD_SUCCESS) {
238 ERR("Error parsing PID string");
239 usage(stderr, cmd_str);
240 retval = CMD_ERROR;
241 goto end;
242 }
243
244 handle = lttng_create_handle(session_name, &dom);
245 if (handle == NULL) {
246 retval = CMD_ERROR;
247 goto end;
248 }
249
250 if (writer) {
251 /* Open process element */
252 ret = mi_lttng_targets_open(writer);
253 if (ret) {
254 retval = CMD_ERROR;
255 goto end;
256 }
257 }
258
259 for (i = 0; i < nr_pids; i++) {
260 DBG("%s PID %d", cmd_str, pid_list[i]);
261 ret = lib_func(handle, pid_list[i]);
262 if (ret) {
263 success = 0;
264 retval = CMD_ERROR;
265 } else {
266 success = 1;
267 }
268
269 /* Mi */
270 if (writer) {
271 ret = mi_lttng_pid_target(writer, pid_list[i], 1);
272 if (ret) {
273 retval = CMD_ERROR;
274 goto end;
275 }
276
277 ret = mi_lttng_writer_write_element_bool(writer,
278 mi_lttng_element_success, success);
279 if (ret) {
280 retval = CMD_ERROR;
281 goto end;
282 }
283
284 ret = mi_lttng_writer_close_element(writer);
285 if (ret) {
286 retval = CMD_ERROR;
287 goto end;
288 }
289 }
290 }
291
292 if (writer) {
293 /* Close targets element */
294 ret = mi_lttng_writer_close_element(writer);
295 if (ret) {
296 retval = CMD_ERROR;
297 goto end;
298 }
299 }
300
301 end:
302 if (handle) {
303 lttng_destroy_handle(handle);
304 }
305 free(pid_list);
306 return retval;
307 }
308
309 static
310 const char *get_mi_element_command(enum cmd_type cmd_type)
311 {
312 switch (cmd_type) {
313 case CMD_TRACK:
314 return mi_lttng_element_command_track;
315 case CMD_UNTRACK:
316 return mi_lttng_element_command_untrack;
317 default:
318 return NULL;
319 }
320 }
321
322 /*
323 * Add/remove tracker to/from session.
324 */
325 static
326 int cmd_track_untrack(enum cmd_type cmd_type, const char *cmd_str,
327 int argc, const char **argv)
328 {
329 int opt, ret = CMD_SUCCESS, command_ret = CMD_SUCCESS;
330 int success = 1;
331 static poptContext pc;
332 char *session_name = NULL;
333 struct mi_writer *writer = NULL;
334
335 if (argc < 1) {
336 usage(stderr, cmd_str);
337 ret = CMD_ERROR;
338 goto end;
339 }
340
341 pc = poptGetContext(NULL, argc, argv, long_options, 0);
342 poptReadDefaultConfig(pc, 0);
343
344 while ((opt = poptGetNextOpt(pc)) != -1) {
345 switch (opt) {
346 case OPT_HELP:
347 usage(stdout, cmd_str);
348 goto end;
349 case OPT_LIST_OPTIONS:
350 list_cmd_options(stdout, long_options);
351 goto end;
352 case OPT_SESSION:
353 case OPT_PID:
354 opt_pid = 1;
355 break;
356 default:
357 usage(stderr, cmd_str);
358 ret = CMD_UNDEFINED;
359 goto end;
360 }
361 }
362
363 if (!(opt_userspace ^ opt_kernel)) {
364 ERR("Exactly one of -u or -k needs to be specified.");
365 usage(stderr, cmd_str);
366 ret = CMD_ERROR;
367 goto end;
368 }
369
370 if (!opt_session_name) {
371 session_name = get_session_name();
372 if (session_name == NULL) {
373 ret = CMD_ERROR;
374 goto end;
375 }
376 } else {
377 session_name = opt_session_name;
378 }
379
380 /* Currently only PID tracker is supported */
381 if (!opt_pid) {
382 ERR("Please specify at least one tracker with its expected arguments");
383 usage(stderr, cmd_str);
384 ret = CMD_ERROR;
385 goto end;
386 }
387
388 /* Mi check */
389 if (lttng_opt_mi) {
390 writer = mi_lttng_writer_create(fileno(stdout), lttng_opt_mi);
391 if (!writer) {
392 ret = CMD_ERROR;
393 goto end;
394 }
395 }
396
397 if (writer) {
398 /* Open command element */
399 ret = mi_lttng_writer_command_open(writer,
400 get_mi_element_command(cmd_type));
401 if (ret) {
402 ret = CMD_ERROR;
403 goto end;
404 }
405
406 /* Open output element */
407 ret = mi_lttng_writer_open_element(writer,
408 mi_lttng_element_command_output);
409 if (ret) {
410 ret = CMD_ERROR;
411 goto end;
412 }
413 }
414
415 command_ret = track_untrack_pid(cmd_type,
416 cmd_str, session_name, opt_pid_string,
417 opt_all, writer);
418 if (command_ret) {
419 success = 0;
420 }
421
422 /* Mi closing */
423 if (writer) {
424 /* Close output element */
425 ret = mi_lttng_writer_close_element(writer);
426 if (ret) {
427 ret = CMD_ERROR;
428 goto end;
429 }
430
431 /* Success ? */
432 ret = mi_lttng_writer_write_element_bool(writer,
433 mi_lttng_element_command_success, success);
434 if (ret) {
435 ret = CMD_ERROR;
436 goto end;
437 }
438
439 /* Command element close */
440 ret = mi_lttng_writer_command_close(writer);
441 if (ret) {
442 ret = CMD_ERROR;
443 goto end;
444 }
445 }
446
447 end:
448 if (!opt_session_name) {
449 free(session_name);
450 }
451
452 /* Mi clean-up */
453 if (writer && mi_lttng_writer_destroy(writer)) {
454 /* Preserve original error code */
455 ret = ret ? ret : LTTNG_ERR_MI_IO_FAIL;
456 }
457
458 /* Overwrite ret if an error occurred during track() */
459 ret = command_ret ? command_ret : ret;
460
461 poptFreeContext(pc);
462 return ret;
463 }
464
465 int cmd_track(int argc, const char **argv)
466 {
467 return cmd_track_untrack(CMD_TRACK, "track", argc, argv);
468 }
469
470 int cmd_untrack(int argc, const char **argv)
471 {
472 return cmd_track_untrack(CMD_UNTRACK, "untrack", argc, argv);
473 }
This page took 0.0398579999999999 seconds and 4 git commands to generate.