[lttng-tools.git] / src / bin / lttng / commands / list.c

/*
 * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2 only,
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#define _GNU_SOURCE
#include <inttypes.h>
#include <popt.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>

#include "../command.h"

#include <common/sessiond-comm/sessiond-comm.h>

static int opt_userspace;
static int opt_kernel;
static char *opt_channel;
static int opt_domain;
#if 0
/* Not implemented yet */
static char *opt_cmd_name;
static pid_t opt_pid;
#endif

const char *indent4 = "    ";
const char *indent6 = "      ";
const char *indent8 = "        ";

enum {
	OPT_HELP = 1,
	OPT_USERSPACE,
	OPT_LIST_OPTIONS,
};

static struct lttng_handle *handle;

static struct poptOption long_options[] = {
	/* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
	{"help",      'h', POPT_ARG_NONE, 0, OPT_HELP, 0, 0},
	{"kernel",    'k', POPT_ARG_VAL, &opt_kernel, 1, 0, 0},
#if 0
	/* Not implemented yet */
	{"userspace",      'u', POPT_ARG_STRING | POPT_ARGFLAG_OPTIONAL, &opt_cmd_name, OPT_USERSPACE, 0, 0},
	{"pid",            'p', POPT_ARG_INT, &opt_pid, 0, 0, 0},
#else
	{"userspace",      'u', POPT_ARG_NONE, 0, OPT_USERSPACE, 0, 0},
#endif
	{"channel",   'c', POPT_ARG_STRING, &opt_channel, 0, 0, 0},
	{"domain",    'd', POPT_ARG_VAL, &opt_domain, 1, 0, 0},
	{"list-options", 0, POPT_ARG_NONE, NULL, OPT_LIST_OPTIONS, NULL, NULL},
	{0, 0, 0, 0, 0, 0, 0}
};

/*
 * usage
 */
static void usage(FILE *ofp)
{
	fprintf(ofp, "usage: lttng list [OPTIONS] [SESSION [<OPTIONS>]]\n");
	fprintf(ofp, "\n");
	fprintf(ofp, "With no arguments, list available tracing session(s)\n");
	fprintf(ofp, "\n");
	fprintf(ofp, "Without a session, -k lists available kernel events\n");
	fprintf(ofp, "Without a session, -u lists available userspace events\n");
	fprintf(ofp, "\n");
	fprintf(ofp, "  -h, --help              Show this help\n");
	fprintf(ofp, "      --list-options      Simple listing of options\n");
	fprintf(ofp, "  -k, --kernel            Select kernel domain\n");
	fprintf(ofp, "  -u, --userspace         Select user-space domain.\n");
#if 0
	fprintf(ofp, "  -p, --pid PID           List user-space events by PID\n");
#endif
	fprintf(ofp, "\n");
	fprintf(ofp, "Session Options:\n");
	fprintf(ofp, "  -c, --channel NAME      List details of a channel\n");
	fprintf(ofp, "  -d, --domain            List available domain(s)\n");
	fprintf(ofp, "\n");
}

/*
 * Get command line from /proc for a specific pid.
 *
 * On success, return an allocated string pointer to the proc cmdline.
 * On error, return NULL.
 */
static char *get_cmdline_by_pid(pid_t pid)
{
	int ret;
	FILE *fp;
	char *cmdline = NULL;
	char path[24];	/* Can't go bigger than /proc/65535/cmdline */

	snprintf(path, sizeof(path), "/proc/%d/cmdline", pid);
	fp = fopen(path, "r");
	if (fp == NULL) {
		goto end;
	}

	/* Caller must free() *cmdline */
	cmdline = malloc(PATH_MAX);
	ret = fread(cmdline, 1, PATH_MAX, fp);
	if (ret < 0) {
		perror("fread proc list");
	}
	fclose(fp);

end:
	return cmdline;
}

static
const char *active_string(int value)
{
	switch (value) {
	case 0:	return " [inactive]";
	case 1: return " [active]";
	case -1: return "";
	default: return NULL;
	}
}

static
const char *enabled_string(int value)
{
	switch (value) {
	case 0:	return " [disabled]";
	case 1: return " [enabled]";
	case -1: return "";
	default: return NULL;
	}
}

static const char *loglevel_string(int value)
{
	switch (value) {
	case -1:
		return "";
	case LTTNG_LOGLEVEL_EMERG:
		return "TRACE_EMERG";
	case LTTNG_LOGLEVEL_ALERT:
		return "TRACE_ALERT";
	case LTTNG_LOGLEVEL_CRIT:
		return "TRACE_CRIT";
	case LTTNG_LOGLEVEL_ERR:
		return "TRACE_ERR";
	case LTTNG_LOGLEVEL_WARNING:
		return "TRACE_WARNING";
	case LTTNG_LOGLEVEL_NOTICE:
		return "TRACE_NOTICE";
	case LTTNG_LOGLEVEL_INFO:
		return "TRACE_INFO";
	case LTTNG_LOGLEVEL_DEBUG_SYSTEM:
		return "TRACE_DEBUG_SYSTEM";
	case LTTNG_LOGLEVEL_DEBUG_PROGRAM:
		return "TRACE_DEBUG_PROGRAM";
	case LTTNG_LOGLEVEL_DEBUG_PROCESS:
		return "TRACE_DEBUG_PROCESS";
	case LTTNG_LOGLEVEL_DEBUG_MODULE:
		return "TRACE_DEBUG_MODULE";
	case LTTNG_LOGLEVEL_DEBUG_UNIT:
		return "TRACE_DEBUG_UNIT";
	case LTTNG_LOGLEVEL_DEBUG_FUNCTION:
		return "TRACE_DEBUG_FUNCTION";
	case LTTNG_LOGLEVEL_DEBUG_LINE:
		return "TRACE_DEBUG_LINE";
	case LTTNG_LOGLEVEL_DEBUG:
		return "TRACE_DEBUG";
	default:
		return "<<UNKNOWN>>";
	}
}

/*
 * Pretty print single event.
 */
static void print_events(struct lttng_event *event)
{
	switch (event->type) {
	case LTTNG_EVENT_TRACEPOINT:
	{
		if (event->loglevel != -1) {
			MSG("%s%s (loglevel: %s (%d)) (type: tracepoint)%s",
				indent6,
				event->name,
				loglevel_string(event->loglevel),
				event->loglevel,
				enabled_string(event->enabled));
		} else {
			MSG("%s%s (type: tracepoint)%s",
				indent6,
				event->name,
				enabled_string(event->enabled));
		}
		break;
	}
	case LTTNG_EVENT_PROBE:
		MSG("%s%s (type: probe)%s", indent6,
				event->name, enabled_string(event->enabled));
		if (event->attr.probe.addr != 0) {
			MSG("%saddr: 0x%" PRIx64, indent8, event->attr.probe.addr);
		} else {
			MSG("%soffset: 0x%" PRIx64, indent8, event->attr.probe.offset);
			MSG("%ssymbol: %s", indent8, event->attr.probe.symbol_name);
		}
		break;
	case LTTNG_EVENT_FUNCTION:
	case LTTNG_EVENT_FUNCTION_ENTRY:
		MSG("%s%s (type: function)%s", indent6,
				event->name, enabled_string(event->enabled));
		MSG("%ssymbol: \"%s\"", indent8, event->attr.ftrace.symbol_name);
		break;
	case LTTNG_EVENT_SYSCALL:
		MSG("%ssyscalls (type: syscall)%s", indent6,
				enabled_string(event->enabled));
		break;
	case LTTNG_EVENT_NOOP:
		MSG("%s (type: noop)%s", indent6,
				enabled_string(event->enabled));
		break;
	case LTTNG_EVENT_ALL:
		/* We should never have "all" events in list. */
		assert(0);
		break;
	}
}

/*
 * Ask session daemon for all user space tracepoints available.
 */
static int list_ust_events(void)
{
	int i, size;
	struct lttng_domain domain;
	struct lttng_handle *handle;
	struct lttng_event *event_list;
	pid_t cur_pid = 0;

	memset(&domain, 0, sizeof(domain));

	DBG("Getting UST tracing events");

	domain.type = LTTNG_DOMAIN_UST;

	handle = lttng_create_handle(NULL, &domain);
	if (handle == NULL) {
		goto error;
	}

	size = lttng_list_tracepoints(handle, &event_list);
	if (size < 0) {
		ERR("Unable to list UST events");
		lttng_destroy_handle(handle);
		return size;
	}

	MSG("UST events:\n-------------");

	if (size == 0) {
		MSG("None");
	}

	for (i = 0; i < size; i++) {
		if (cur_pid != event_list[i].pid) {
			cur_pid = event_list[i].pid;
			MSG("\nPID: %d - Name: %s", cur_pid, get_cmdline_by_pid(cur_pid));
		}
		print_events(&event_list[i]);
	}

	MSG("");

	free(event_list);
	lttng_destroy_handle(handle);

	return CMD_SUCCESS;

error:
	lttng_destroy_handle(handle);
	return -1;
}

/*
 * Ask for all trace events in the kernel and pretty print them.
 */
static int list_kernel_events(void)
{
	int i, size;
	struct lttng_domain domain;
	struct lttng_handle *handle;
	struct lttng_event *event_list;

	memset(&domain, 0, sizeof(domain));

	DBG("Getting kernel tracing events");

	domain.type = LTTNG_DOMAIN_KERNEL;

	handle = lttng_create_handle(NULL, &domain);
	if (handle == NULL) {
		goto error;
	}

	size = lttng_list_tracepoints(handle, &event_list);
	if (size < 0) {
		ERR("Unable to list kernel events");
		lttng_destroy_handle(handle);
		return size;
	}

	MSG("Kernel events:\n-------------");

	for (i = 0; i < size; i++) {
		print_events(&event_list[i]);
	}

	MSG("");

	free(event_list);

	lttng_destroy_handle(handle);
	return CMD_SUCCESS;

error:
	lttng_destroy_handle(handle);
	return -1;
}

/*
 * List events of channel of session and domain.
 */
static int list_events(const char *channel_name)
{
	int ret, count, i;
	struct lttng_event *events = NULL;

	count = lttng_list_events(handle, channel_name, &events);
	if (count < 0) {
		ret = count;
		goto error;
	}

	MSG("\n%sEvents:", indent4);
	if (count == 0) {
		MSG("%sNone\n", indent6);
		goto end;
	}

	for (i = 0; i < count; i++) {
		print_events(&events[i]);
	}

	MSG("");

end:
	if (events) {
		free(events);
	}
	ret = CMD_SUCCESS;

error:
	return ret;
}

/*
 * Pretty print channel
 */
static void print_channel(struct lttng_channel *channel)
{
	MSG("- %s:%s\n", channel->name, enabled_string(channel->enabled));

	MSG("%sAttributes:", indent4);
	MSG("%soverwrite mode: %d", indent6, channel->attr.overwrite);
	MSG("%ssubbufers size: %" PRIu64, indent6, channel->attr.subbuf_size);
	MSG("%snumber of subbufers: %" PRIu64, indent6, channel->attr.num_subbuf);
	MSG("%sswitch timer interval: %u", indent6, channel->attr.switch_timer_interval);
	MSG("%sread timer interval: %u", indent6, channel->attr.read_timer_interval);
	switch (channel->attr.output) {
		case LTTNG_EVENT_SPLICE:
			MSG("%soutput: splice()", indent6);
			break;
		case LTTNG_EVENT_MMAP:
			MSG("%soutput: mmap()", indent6);
			break;
	}
}

/*
 * List channel(s) of session and domain.
 *
 * If channel_name is NULL, all channels are listed.
 */
static int list_channels(const char *channel_name)
{
	int count, i, ret = CMD_SUCCESS;
	unsigned int chan_found = 0;
	struct lttng_channel *channels = NULL;

	DBG("Listing channel(s) (%s)", channel_name ? : "<all>");

	count = lttng_list_channels(handle, &channels);
	if (count < 0) {
		switch (-count) {
		case LTTCOMM_KERN_CHAN_NOT_FOUND:
			ret = CMD_SUCCESS;
			WARN("No kernel channel");
			break;
		case LTTCOMM_UST_CHAN_NOT_FOUND:
			ret = CMD_SUCCESS;
			WARN("No UST channel");
			break;
		default:
			/* We had a real error */
			ret = count;
			ERR("%s", lttng_strerror(ret));
		}
		goto error_channels;
	}

	if (channel_name == NULL) {
		MSG("Channels:\n-------------");
	}

	for (i = 0; i < count; i++) {
		if (channel_name != NULL) {
			if (strncmp(channels[i].name, channel_name, NAME_MAX) == 0) {
				chan_found = 1;
			} else {
				continue;
			}
		}
		print_channel(&channels[i]);

		/* Listing events per channel */
		ret = list_events(channels[i].name);
		if (ret < 0) {
			MSG("%s", lttng_strerror(ret));
		}

		if (chan_found) {
			break;
		}
	}

	if (!chan_found && channel_name != NULL) {
		ERR("Channel %s not found", channel_name);
		goto error;
	}

	ret = CMD_SUCCESS;

error:
	free(channels);

error_channels:
	return ret;
}

/*
 * List available tracing session. List only basic information.
 *
 * If session_name is NULL, all sessions are listed.
 */
static int list_sessions(const char *session_name)
{
	int ret, count, i;
	unsigned int session_found = 0;
	struct lttng_session *sessions;

	count = lttng_list_sessions(&sessions);
	DBG("Session count %d", count);
	if (count < 0) {
		ret = count;
		goto error;
	} else if (count == 0) {
		MSG("Currently no available tracing session");
		goto end;
	}

	if (session_name == NULL) {
		MSG("Available tracing sessions:");
	}

	for (i = 0; i < count; i++) {
		if (session_name != NULL) {
			if (strncmp(sessions[i].name, session_name, NAME_MAX) == 0) {
				session_found = 1;
				MSG("Tracing session %s:%s", session_name, active_string(sessions[i].enabled));
				MSG("%sTrace path: %s\n", indent4, sessions[i].path);
				break;
			}
			continue;
		}

		MSG("  %d) %s (%s)%s", i + 1, sessions[i].name, sessions[i].path,
				active_string(sessions[i].enabled));

		if (session_found) {
			break;
		}
	}

	free(sessions);

	if (!session_found && session_name != NULL) {
		ERR("Session '%s' not found", session_name);
		ret = CMD_ERROR;
		goto error;
	}

	if (session_name == NULL) {
		MSG("\nUse lttng list <session_name> for more details");
	}

end:
	return CMD_SUCCESS;

error:
	return ret;
}

/*
 * List available domain(s) for a session.
 */
static int list_domains(const char *session_name)
{
	int i, count, ret = CMD_SUCCESS;
	struct lttng_domain *domains = NULL;

	MSG("Domains:\n-------------");

	count = lttng_list_domains(session_name, &domains);
	if (count < 0) {
		ret = count;
		goto error;
	} else if (count == 0) {
		MSG("  None");
		goto end;
	}

	for (i = 0; i < count; i++) {
		switch (domains[i].type) {
		case LTTNG_DOMAIN_KERNEL:
			MSG("  - Kernel");
			break;
		case LTTNG_DOMAIN_UST:
			MSG("  - UST global");
			break;
		default:
			break;
		}
	}

end:
	free(domains);

error:
	return ret;
}

/*
 * The 'list <options>' first level command
 */
int cmd_list(int argc, const char **argv)
{
	int opt, i, ret = CMD_SUCCESS;
	int nb_domain;
	const char *session_name;
	static poptContext pc;
	struct lttng_domain domain;
	struct lttng_domain *domains = NULL;

	memset(&domain, 0, sizeof(domain));

	if (argc < 1) {
		usage(stderr);
		ret = CMD_ERROR;
		goto end;
	}

	pc = poptGetContext(NULL, argc, argv, long_options, 0);
	poptReadDefaultConfig(pc, 0);

	while ((opt = poptGetNextOpt(pc)) != -1) {
		switch (opt) {
		case OPT_HELP:
			usage(stdout);
			goto end;
		case OPT_USERSPACE:
			opt_userspace = 1;
			break;
		case OPT_LIST_OPTIONS:
			list_cmd_options(stdout, long_options);
			goto end;
		default:
			usage(stderr);
			ret = CMD_UNDEFINED;
			goto end;
		}
	}

	/* Get session name (trailing argument) */
	session_name = poptGetArg(pc);
	DBG2("Session name: %s", session_name);

	if (opt_kernel) {
		domain.type = LTTNG_DOMAIN_KERNEL;
	} else if (opt_userspace) {
		DBG2("Listing userspace global domain");
		domain.type = LTTNG_DOMAIN_UST;
	}

	if (opt_kernel || opt_userspace) {
		handle = lttng_create_handle(session_name, &domain);
		if (handle == NULL) {
			ret = CMD_FATAL;
			goto end;
		}
	}

	if (session_name == NULL) {
		if (!opt_kernel && !opt_userspace) {
			ret = list_sessions(NULL);
			if (ret != 0) {
				goto end;
			}
		}
		if (opt_kernel) {
			ret = list_kernel_events();
			if (ret < 0) {
				goto end;
			}
		}
		if (opt_userspace) {
			ret = list_ust_events();
			if (ret < 0) {
				goto end;
			}
		}
	} else {
		/* List session attributes */
		ret = list_sessions(session_name);
		if (ret != 0) {
			goto end;
		}

		/* Domain listing */
		if (opt_domain) {
			ret = list_domains(session_name);
			goto end;
		}

		if (opt_kernel) {
			/* Channel listing */
			ret = list_channels(opt_channel);
			if (ret < 0) {
				goto end;
			}
		} else {
			/* We want all domain(s) */
			nb_domain = lttng_list_domains(session_name, &domains);
			if (nb_domain < 0) {
				ret = nb_domain;
				goto end;
			}

			for (i = 0; i < nb_domain; i++) {
				switch (domains[i].type) {
				case LTTNG_DOMAIN_KERNEL:
					MSG("=== Domain: Kernel ===\n");
					break;
				case LTTNG_DOMAIN_UST:
					MSG("=== Domain: UST global ===\n");
					break;
				default:
					MSG("=== Domain: Unimplemented ===\n");
					break;
				}

				/* Clean handle before creating a new one */
				if (handle) {
					lttng_destroy_handle(handle);
				}

				handle = lttng_create_handle(session_name, &domains[i]);
				if (handle == NULL) {
					ret = CMD_FATAL;
					goto end;
				}

				ret = list_channels(opt_channel);
				if (ret < 0) {
					goto end;
				}
			}
		}
	}

end:
	if (domains) {
		free(domains);
	}
	if (handle) {
		lttng_destroy_handle(handle);
	}

	poptFreeContext(pc);
	return ret;
}
Commit	Line	Data
f3ed775e DG	1	/*
	2	* Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
	3	*
d14d33bf AM	4	* This program is free software; you can redistribute it and/or modify
	5	* it under the terms of the GNU General Public License, version 2 only,
	6	* as published by the Free Software Foundation.
f3ed775e DG	7	*
	8	* This program is distributed in the hope that it will be useful,
	9	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	10	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	11	* GNU General Public License for more details.
	12	*
d14d33bf AM	13	* You should have received a copy of the GNU General Public License along
	14	* with this program; if not, write to the Free Software Foundation, Inc.,
	15	* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
f3ed775e DG	16	*/
	17
	18	#define _GNU_SOURCE
9f19cc17	19	#include <inttypes.h>
f3ed775e DG	20	#include <popt.h>
	21	#include <stdio.h>
	22	#include <stdlib.h>
	23	#include <string.h>
7a3d1328	24	#include <assert.h>
f3ed775e	25
c399183f	26	#include "../command.h"
f3ed775e	27
c119cdb1 DG	28	#include <common/sessiond-comm/sessiond-comm.h>
c119cdb1 DG	29
9f19cc17 DG	30	static int opt_userspace;
	31	static int opt_kernel;
	32	static char *opt_channel;
	33	static int opt_domain;
d78d6610 DG	34	#if 0
	35	/* Not implemented yet */
	36	static char *opt_cmd_name;
	37	static pid_t opt_pid;
	38	#endif
9f19cc17 DG	39
	40	const char *indent4 = " ";
	41	const char *indent6 = " ";
	42	const char *indent8 = " ";
f3ed775e DG	43
	44	enum {
	45	OPT_HELP = 1,
eeac7d46	46	OPT_USERSPACE,
679b4943	47	OPT_LIST_OPTIONS,
f3ed775e DG	48	};
f3ed775e DG	49
cd80958d DG	50	static struct lttng_handle *handle;
cd80958d DG	51
f3ed775e DG	52	static struct poptOption long_options[] = {
	53	/* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
	54	{"help", 'h', POPT_ARG_NONE, 0, OPT_HELP, 0, 0},
9f19cc17	55	{"kernel", 'k', POPT_ARG_VAL, &opt_kernel, 1, 0, 0},
d78d6610 DG	56	#if 0
	57	/* Not implemented yet */
	58	{"userspace", 'u', POPT_ARG_STRING \| POPT_ARGFLAG_OPTIONAL, &opt_cmd_name, OPT_USERSPACE, 0, 0},
	59	{"pid", 'p', POPT_ARG_INT, &opt_pid, 0, 0, 0},
	60	#else
	61	{"userspace", 'u', POPT_ARG_NONE, 0, OPT_USERSPACE, 0, 0},
	62	#endif
9f19cc17 DG	63	{"channel", 'c', POPT_ARG_STRING, &opt_channel, 0, 0, 0},
9f19cc17 DG	64	{"domain", 'd', POPT_ARG_VAL, &opt_domain, 1, 0, 0},
679b4943	65	{"list-options", 0, POPT_ARG_NONE, NULL, OPT_LIST_OPTIONS, NULL, NULL},
f3ed775e DG	66	{0, 0, 0, 0, 0, 0, 0}
	67	};
	68
	69	/*
	70	* usage
	71	*/
	72	static void usage(FILE *ofp)
	73	{
27221701	74	fprintf(ofp, "usage: lttng list [OPTIONS] [SESSION [<OPTIONS>]]\n");
9f19cc17 DG	75	fprintf(ofp, "\n");
	76	fprintf(ofp, "With no arguments, list available tracing session(s)\n");
	77	fprintf(ofp, "\n");
27221701 DG	78	fprintf(ofp, "Without a session, -k lists available kernel events\n");
27221701 DG	79	fprintf(ofp, "Without a session, -u lists available userspace events\n");
9f19cc17 DG	80	fprintf(ofp, "\n");
9f19cc17 DG	81	fprintf(ofp, " -h, --help Show this help\n");
27221701	82	fprintf(ofp, " --list-options Simple listing of options\n");
9f19cc17 DG	83	fprintf(ofp, " -k, --kernel Select kernel domain\n");
9f19cc17 DG	84	fprintf(ofp, " -u, --userspace Select user-space domain.\n");
d78d6610	85	#if 0
9f19cc17	86	fprintf(ofp, " -p, --pid PID List user-space events by PID\n");
d78d6610	87	#endif
f3ed775e	88	fprintf(ofp, "\n");
27221701	89	fprintf(ofp, "Session Options:\n");
9f19cc17 DG	90	fprintf(ofp, " -c, --channel NAME List details of a channel\n");
9f19cc17 DG	91	fprintf(ofp, " -d, --domain List available domain(s)\n");
f3ed775e DG	92	fprintf(ofp, "\n");
	93	}
	94
	95	/*
9f19cc17	96	* Get command line from /proc for a specific pid.
f3ed775e	97	*
9f19cc17 DG	98	* On success, return an allocated string pointer to the proc cmdline.
9f19cc17 DG	99	* On error, return NULL.
f3ed775e DG	100	*/
	101	static char *get_cmdline_by_pid(pid_t pid)
	102	{
	103	int ret;
	104	FILE *fp;
	105	char *cmdline = NULL;
	106	char path[24]; /* Can't go bigger than /proc/65535/cmdline */
	107
	108	snprintf(path, sizeof(path), "/proc/%d/cmdline", pid);
	109	fp = fopen(path, "r");
	110	if (fp == NULL) {
	111	goto end;
	112	}
	113
	114	/* Caller must free() cmdline /
	115	cmdline = malloc(PATH_MAX);
	116	ret = fread(cmdline, 1, PATH_MAX, fp);
f40799e8 DG	117	if (ret < 0) {
	118	perror("fread proc list");
	119	}
f3ed775e DG	120	fclose(fp);
	121
	122	end:
	123	return cmdline;
	124	}
b551a063	125
464dd62d MD	126	static
	127	const char *active_string(int value)
	128	{
	129	switch (value) {
b09f0429 MD	130	case 0: return " [inactive]";
b09f0429 MD	131	case 1: return " [active]";
464dd62d MD	132	case -1: return "";
	133	default: return NULL;
	134	}
	135	}
	136
	137	static
	138	const char *enabled_string(int value)
	139	{
	140	switch (value) {
b09f0429 MD	141	case 0: return " [disabled]";
b09f0429 MD	142	case 1: return " [enabled]";
464dd62d MD	143	case -1: return "";
	144	default: return NULL;
	145	}
	146	}
	147
8005f29a MD	148	static const char *loglevel_string(int value)
	149	{
	150	switch (value) {
255a5dab MD	151	case -1:
	152	return "";
	153	case LTTNG_LOGLEVEL_EMERG:
	154	return "TRACE_EMERG";
	155	case LTTNG_LOGLEVEL_ALERT:
	156	return "TRACE_ALERT";
	157	case LTTNG_LOGLEVEL_CRIT:
	158	return "TRACE_CRIT";
	159	case LTTNG_LOGLEVEL_ERR:
	160	return "TRACE_ERR";
	161	case LTTNG_LOGLEVEL_WARNING:
	162	return "TRACE_WARNING";
	163	case LTTNG_LOGLEVEL_NOTICE:
	164	return "TRACE_NOTICE";
	165	case LTTNG_LOGLEVEL_INFO:
	166	return "TRACE_INFO";
	167	case LTTNG_LOGLEVEL_DEBUG_SYSTEM:
	168	return "TRACE_DEBUG_SYSTEM";
	169	case LTTNG_LOGLEVEL_DEBUG_PROGRAM:
	170	return "TRACE_DEBUG_PROGRAM";
	171	case LTTNG_LOGLEVEL_DEBUG_PROCESS:
	172	return "TRACE_DEBUG_PROCESS";
	173	case LTTNG_LOGLEVEL_DEBUG_MODULE:
	174	return "TRACE_DEBUG_MODULE";
	175	case LTTNG_LOGLEVEL_DEBUG_UNIT:
	176	return "TRACE_DEBUG_UNIT";
	177	case LTTNG_LOGLEVEL_DEBUG_FUNCTION:
	178	return "TRACE_DEBUG_FUNCTION";
	179	case LTTNG_LOGLEVEL_DEBUG_LINE:
	180	return "TRACE_DEBUG_LINE";
	181	case LTTNG_LOGLEVEL_DEBUG:
	182	return "TRACE_DEBUG";
	183	default:
	184	return "<<UNKNOWN>>";
8005f29a MD	185	}
	186	}
	187
b551a063 DG	188	/*
	189	* Pretty print single event.
	190	*/
	191	static void print_events(struct lttng_event *event)
	192	{
	193	switch (event->type) {
	194	case LTTNG_EVENT_TRACEPOINT:
e4baff1e	195	{
8b703175 MD	196	if (event->loglevel != -1) {
	197	MSG("%s%s (loglevel: %s (%d)) (type: tracepoint)%s",
	198	indent6,
81afa345	199	event->name,
8005f29a	200	loglevel_string(event->loglevel),
8b703175	201	event->loglevel,
81afa345	202	enabled_string(event->enabled));
8b703175 MD	203	} else {
	204	MSG("%s%s (type: tracepoint)%s",
	205	indent6,
	206	event->name,
	207	enabled_string(event->enabled));
	208	}
b551a063	209	break;
e4baff1e	210	}
b551a063	211	case LTTNG_EVENT_PROBE:
464dd62d MD	212	MSG("%s%s (type: probe)%s", indent6,
464dd62d MD	213	event->name, enabled_string(event->enabled));
b551a063 DG	214	if (event->attr.probe.addr != 0) {
	215	MSG("%saddr: 0x%" PRIx64, indent8, event->attr.probe.addr);
	216	} else {
	217	MSG("%soffset: 0x%" PRIx64, indent8, event->attr.probe.offset);
	218	MSG("%ssymbol: %s", indent8, event->attr.probe.symbol_name);
	219	}
	220	break;
	221	case LTTNG_EVENT_FUNCTION:
	222	case LTTNG_EVENT_FUNCTION_ENTRY:
464dd62d MD	223	MSG("%s%s (type: function)%s", indent6,
464dd62d MD	224	event->name, enabled_string(event->enabled));
b551a063 DG	225	MSG("%ssymbol: \"%s\"", indent8, event->attr.ftrace.symbol_name);
	226	break;
	227	case LTTNG_EVENT_SYSCALL:
2c425ff7	228	MSG("%ssyscalls (type: syscall)%s", indent6,
464dd62d	229	enabled_string(event->enabled));
b551a063 DG	230	break;
b551a063 DG	231	case LTTNG_EVENT_NOOP:
464dd62d MD	232	MSG("%s (type: noop)%s", indent6,
464dd62d MD	233	enabled_string(event->enabled));
b551a063 DG	234	break;
	235	case LTTNG_EVENT_ALL:
	236	/* We should never have "all" events in list. */
	237	assert(0);
	238	break;
	239	}
	240	}
	241
	242	/*
	243	* Ask session daemon for all user space tracepoints available.
	244	*/
	245	static int list_ust_events(void)
	246	{
	247	int i, size;
	248	struct lttng_domain domain;
	249	struct lttng_handle *handle;
	250	struct lttng_event *event_list;
	251	pid_t cur_pid = 0;
	252
441c16a7 MD	253	memset(&domain, 0, sizeof(domain));
441c16a7 MD	254
b551a063 DG	255	DBG("Getting UST tracing events");
	256
	257	domain.type = LTTNG_DOMAIN_UST;
	258
	259	handle = lttng_create_handle(NULL, &domain);
	260	if (handle == NULL) {
	261	goto error;
	262	}
	263
	264	size = lttng_list_tracepoints(handle, &event_list);
	265	if (size < 0) {
	266	ERR("Unable to list UST events");
ef021732	267	lttng_destroy_handle(handle);
b551a063 DG	268	return size;
	269	}
	270
	271	MSG("UST events:\n-------------");
	272
	273	if (size == 0) {
	274	MSG("None");
	275	}
	276
	277	for (i = 0; i < size; i++) {
	278	if (cur_pid != event_list[i].pid) {
	279	cur_pid = event_list[i].pid;
	280	MSG("\nPID: %d - Name: %s", cur_pid, get_cmdline_by_pid(cur_pid));
	281	}
	282	print_events(&event_list[i]);
	283	}
	284
	285	MSG("");
	286
	287	free(event_list);
ef021732	288	lttng_destroy_handle(handle);
b551a063 DG	289
	290	return CMD_SUCCESS;
	291
	292	error:
ef021732	293	lttng_destroy_handle(handle);
b551a063 DG	294	return -1;
b551a063 DG	295	}
f3ed775e DG	296
f3ed775e DG	297	/*
9f19cc17	298	* Ask for all trace events in the kernel and pretty print them.
f3ed775e	299	*/
9f19cc17	300	static int list_kernel_events(void)
f3ed775e	301	{
9f19cc17	302	int i, size;
b551a063 DG	303	struct lttng_domain domain;
b551a063 DG	304	struct lttng_handle *handle;
9f19cc17	305	struct lttng_event *event_list;
f3ed775e	306
441c16a7 MD	307	memset(&domain, 0, sizeof(domain));
441c16a7 MD	308
b551a063 DG	309	DBG("Getting kernel tracing events");
	310
	311	domain.type = LTTNG_DOMAIN_KERNEL;
	312
	313	handle = lttng_create_handle(NULL, &domain);
	314	if (handle == NULL) {
	315	goto error;
	316	}
f3ed775e	317
cd80958d	318	size = lttng_list_tracepoints(handle, &event_list);
9f19cc17 DG	319	if (size < 0) {
9f19cc17 DG	320	ERR("Unable to list kernel events");
ef021732	321	lttng_destroy_handle(handle);
9f19cc17	322	return size;
f3ed775e DG	323	}
f3ed775e DG	324
9f19cc17	325	MSG("Kernel events:\n-------------");
f3ed775e	326
9f19cc17	327	for (i = 0; i < size; i++) {
b551a063	328	print_events(&event_list[i]);
f3ed775e DG	329	}
f3ed775e DG	330
b551a063 DG	331	MSG("");
b551a063 DG	332
f3ed775e DG	333	free(event_list);
f3ed775e DG	334
ef021732	335	lttng_destroy_handle(handle);
f3ed775e	336	return CMD_SUCCESS;
b551a063 DG	337
b551a063 DG	338	error:
ef021732	339	lttng_destroy_handle(handle);
b551a063	340	return -1;
f3ed775e DG	341	}
	342
	343	/*
9f19cc17	344	* List events of channel of session and domain.
f3ed775e	345	*/
cd80958d	346	static int list_events(const char *channel_name)
f3ed775e DG	347	{
f3ed775e DG	348	int ret, count, i;
9f19cc17	349	struct lttng_event *events = NULL;
f3ed775e	350
cd80958d	351	count = lttng_list_events(handle, channel_name, &events);
f3ed775e DG	352	if (count < 0) {
	353	ret = count;
	354	goto error;
	355	}
	356
9f19cc17 DG	357	MSG("\n%sEvents:", indent4);
9f19cc17 DG	358	if (count == 0) {
5edd7e09	359	MSG("%sNone\n", indent6);
9f19cc17 DG	360	goto end;
	361	}
	362
f3ed775e	363	for (i = 0; i < count; i++) {
b551a063	364	print_events(&events[i]);
f3ed775e DG	365	}
f3ed775e DG	366
9f19cc17	367	MSG("");
f3ed775e	368
9f19cc17 DG	369	end:
	370	if (events) {
	371	free(events);
	372	}
	373	ret = CMD_SUCCESS;
f3ed775e DG	374
	375	error:
	376	return ret;
	377	}
	378
	379	/*
9f19cc17 DG	380	* Pretty print channel
	381	*/
	382	static void print_channel(struct lttng_channel *channel)
	383	{
464dd62d	384	MSG("- %s:%s\n", channel->name, enabled_string(channel->enabled));
9f19cc17 DG	385
	386	MSG("%sAttributes:", indent4);
	387	MSG("%soverwrite mode: %d", indent6, channel->attr.overwrite);
	388	MSG("%ssubbufers size: %" PRIu64, indent6, channel->attr.subbuf_size);
	389	MSG("%snumber of subbufers: %" PRIu64, indent6, channel->attr.num_subbuf);
	390	MSG("%sswitch timer interval: %u", indent6, channel->attr.switch_timer_interval);
	391	MSG("%sread timer interval: %u", indent6, channel->attr.read_timer_interval);
	392	switch (channel->attr.output) {
	393	case LTTNG_EVENT_SPLICE:
	394	MSG("%soutput: splice()", indent6);
	395	break;
	396	case LTTNG_EVENT_MMAP:
	397	MSG("%soutput: mmap()", indent6);
	398	break;
	399	}
	400	}
	401
	402	/*
	403	* List channel(s) of session and domain.
f3ed775e	404	*
9f19cc17	405	* If channel_name is NULL, all channels are listed.
f3ed775e	406	*/
cd80958d	407	static int list_channels(const char *channel_name)
f3ed775e	408	{
9f19cc17 DG	409	int count, i, ret = CMD_SUCCESS;
	410	unsigned int chan_found = 0;
	411	struct lttng_channel *channels = NULL;
f3ed775e	412
3e25cb20	413	DBG("Listing channel(s) (%s)", channel_name ? : "<all>");
9f19cc17	414
cd80958d	415	count = lttng_list_channels(handle, &channels);
f3ed775e	416	if (count < 0) {
c119cdb1 DG	417	switch (-count) {
	418	case LTTCOMM_KERN_CHAN_NOT_FOUND:
	419	ret = CMD_SUCCESS;
	420	WARN("No kernel channel");
	421	break;
	422	case LTTCOMM_UST_CHAN_NOT_FOUND:
	423	ret = CMD_SUCCESS;
	424	WARN("No UST channel");
	425	break;
	426	default:
	427	/* We had a real error */
	428	ret = count;
	429	ERR("%s", lttng_strerror(ret));
	430	}
ae856491	431	goto error_channels;
f3ed775e DG	432	}
f3ed775e DG	433
9f19cc17 DG	434	if (channel_name == NULL) {
	435	MSG("Channels:\n-------------");
	436	}
	437
	438	for (i = 0; i < count; i++) {
	439	if (channel_name != NULL) {
	440	if (strncmp(channels[i].name, channel_name, NAME_MAX) == 0) {
	441	chan_found = 1;
	442	} else {
	443	continue;
	444	}
	445	}
	446	print_channel(&channels[i]);
	447
	448	/* Listing events per channel */
cd80958d	449	ret = list_events(channels[i].name);
9f19cc17	450	if (ret < 0) {
9a745bc7	451	MSG("%s", lttng_strerror(ret));
9f19cc17 DG	452	}
	453
	454	if (chan_found) {
	455	break;
f3ed775e	456	}
f3ed775e DG	457	}
f3ed775e DG	458
9f19cc17	459	if (!chan_found && channel_name != NULL) {
ae856491 DG	460	ERR("Channel %s not found", channel_name);
ae856491 DG	461	goto error;
9f19cc17	462	}
f3ed775e	463
9f19cc17	464	ret = CMD_SUCCESS;
f3ed775e DG	465
f3ed775e DG	466	error:
ae856491 DG	467	free(channels);
	468
	469	error_channels:
f3ed775e DG	470	return ret;
	471	}
	472
	473	/*
9f19cc17	474	* List available tracing session. List only basic information.
f3ed775e	475	*
9f19cc17	476	* If session_name is NULL, all sessions are listed.
f3ed775e	477	*/
9f19cc17	478	static int list_sessions(const char *session_name)
f3ed775e	479	{
9f19cc17 DG	480	int ret, count, i;
	481	unsigned int session_found = 0;
	482	struct lttng_session *sessions;
	483
	484	count = lttng_list_sessions(&sessions);
	485	DBG("Session count %d", count);
	486	if (count < 0) {
	487	ret = count;
	488	goto error;
d32fb093 DG	489	} else if (count == 0) {
	490	MSG("Currently no available tracing session");
	491	goto end;
9f19cc17 DG	492	}
	493
	494	if (session_name == NULL) {
	495	MSG("Available tracing sessions:");
	496	}
	497
	498	for (i = 0; i < count; i++) {
	499	if (session_name != NULL) {
	500	if (strncmp(sessions[i].name, session_name, NAME_MAX) == 0) {
	501	session_found = 1;
464dd62d	502	MSG("Tracing session %s:%s", session_name, active_string(sessions[i].enabled));
9f19cc17 DG	503	MSG("%sTrace path: %s\n", indent4, sessions[i].path);
	504	break;
	505	}
cd80958d	506	continue;
9f19cc17 DG	507	}
9f19cc17 DG	508
b6913340 DG	509	MSG(" %d) %s (%s)%s", i + 1, sessions[i].name, sessions[i].path,
b6913340 DG	510	active_string(sessions[i].enabled));
9f19cc17 DG	511
	512	if (session_found) {
	513	break;
	514	}
	515	}
	516
	517	free(sessions);
	518
	519	if (!session_found && session_name != NULL) {
b6913340 DG	520	ERR("Session '%s' not found", session_name);
	521	ret = CMD_ERROR;
	522	goto error;
9f19cc17 DG	523	}
	524
	525	if (session_name == NULL) {
6e0de39b	526	MSG("\nUse lttng list <session_name> for more details");
9f19cc17	527	}
f3ed775e	528
d32fb093	529	end:
f3ed775e DG	530	return CMD_SUCCESS;
	531
	532	error:
	533	return ret;
	534	}
f3ed775e DG	535
f3ed775e DG	536	/*
9f19cc17	537	* List available domain(s) for a session.
f3ed775e	538	*/
330be774	539	static int list_domains(const char *session_name)
f3ed775e	540	{
9f19cc17 DG	541	int i, count, ret = CMD_SUCCESS;
	542	struct lttng_domain *domains = NULL;
	543
	544	MSG("Domains:\n-------------");
	545
330be774	546	count = lttng_list_domains(session_name, &domains);
9f19cc17 DG	547	if (count < 0) {
	548	ret = count;
	549	goto error;
	550	} else if (count == 0) {
	551	MSG(" None");
	552	goto end;
	553	}
	554
	555	for (i = 0; i < count; i++) {
	556	switch (domains[i].type) {
	557	case LTTNG_DOMAIN_KERNEL:
	558	MSG(" - Kernel");
b551a063 DG	559	break;
	560	case LTTNG_DOMAIN_UST:
	561	MSG(" - UST global");
	562	break;
9f19cc17 DG	563	default:
	564	break;
	565	}
	566	}
	567
	568	end:
	569	free(domains);
	570
	571	error:
	572	return ret;
f3ed775e	573	}
f3ed775e DG	574
f3ed775e DG	575	/*
9f19cc17	576	* The 'list <options>' first level command
f3ed775e DG	577	*/
	578	int cmd_list(int argc, const char **argv)
	579	{
9f19cc17	580	int opt, i, ret = CMD_SUCCESS;
c3919711	581	int nb_domain;
9f19cc17	582	const char *session_name;
f3ed775e	583	static poptContext pc;
9f19cc17 DG	584	struct lttng_domain domain;
9f19cc17 DG	585	struct lttng_domain *domains = NULL;
f3ed775e	586
441c16a7 MD	587	memset(&domain, 0, sizeof(domain));
441c16a7 MD	588
9f19cc17	589	if (argc < 1) {
f3ed775e	590	usage(stderr);
ca1c3607	591	ret = CMD_ERROR;
f3ed775e DG	592	goto end;
	593	}
	594
	595	pc = poptGetContext(NULL, argc, argv, long_options, 0);
	596	poptReadDefaultConfig(pc, 0);
	597
	598	while ((opt = poptGetNextOpt(pc)) != -1) {
	599	switch (opt) {
	600	case OPT_HELP:
ca1c3607	601	usage(stdout);
f3ed775e	602	goto end;
eeac7d46 MD	603	case OPT_USERSPACE:
eeac7d46 MD	604	opt_userspace = 1;
eeac7d46	605	break;
679b4943 SM	606	case OPT_LIST_OPTIONS:
679b4943 SM	607	list_cmd_options(stdout, long_options);
679b4943	608	goto end;
f3ed775e DG	609	default:
	610	usage(stderr);
	611	ret = CMD_UNDEFINED;
	612	goto end;
	613	}
	614	}
	615
9f19cc17 DG	616	/* Get session name (trailing argument) */
9f19cc17 DG	617	session_name = poptGetArg(pc);
b551a063	618	DBG2("Session name: %s", session_name);
9f19cc17	619
cd80958d DG	620	if (opt_kernel) {
cd80958d DG	621	domain.type = LTTNG_DOMAIN_KERNEL;
b551a063 DG	622	} else if (opt_userspace) {
	623	DBG2("Listing userspace global domain");
	624	domain.type = LTTNG_DOMAIN_UST;
cd80958d DG	625	}
cd80958d DG	626
aa5de748 MD	627	if (opt_kernel \|\| opt_userspace) {
	628	handle = lttng_create_handle(session_name, &domain);
	629	if (handle == NULL) {
	630	ret = CMD_FATAL;
	631	goto end;
	632	}
cd80958d DG	633	}
cd80958d DG	634
9f19cc17	635	if (session_name == NULL) {
b551a063 DG	636	if (!opt_kernel && !opt_userspace) {
b551a063 DG	637	ret = list_sessions(NULL);
b6913340	638	if (ret != 0) {
b551a063 DG	639	goto end;
	640	}
	641	}
9f19cc17 DG	642	if (opt_kernel) {
	643	ret = list_kernel_events();
	644	if (ret < 0) {
	645	goto end;
	646	}
b551a063 DG	647	}
	648	if (opt_userspace) {
	649	ret = list_ust_events();
9f19cc17 DG	650	if (ret < 0) {
	651	goto end;
	652	}
	653	}
	654	} else {
	655	/* List session attributes */
	656	ret = list_sessions(session_name);
b6913340	657	if (ret != 0) {
9f19cc17 DG	658	goto end;
	659	}
	660
	661	/* Domain listing */
	662	if (opt_domain) {
330be774	663	ret = list_domains(session_name);
9f19cc17 DG	664	goto end;
	665	}
	666
	667	if (opt_kernel) {
9f19cc17	668	/* Channel listing */
cd80958d	669	ret = list_channels(opt_channel);
9f19cc17 DG	670	if (ret < 0) {
	671	goto end;
	672	}
9f19cc17 DG	673	} else {
9f19cc17 DG	674	/* We want all domain(s) */
330be774	675	nb_domain = lttng_list_domains(session_name, &domains);
b551a063	676	if (nb_domain < 0) {
67635185	677	ret = nb_domain;
9f19cc17 DG	678	goto end;
	679	}
	680
b551a063	681	for (i = 0; i < nb_domain; i++) {
9f19cc17 DG	682	switch (domains[i].type) {
	683	case LTTNG_DOMAIN_KERNEL:
	684	MSG("=== Domain: Kernel ===\n");
	685	break;
b551a063 DG	686	case LTTNG_DOMAIN_UST:
	687	MSG("=== Domain: UST global ===\n");
	688	break;
9f19cc17 DG	689	default:
	690	MSG("=== Domain: Unimplemented ===\n");
	691	break;
	692	}
	693
cd80958d	694	/* Clean handle before creating a new one */
aa5de748 MD	695	if (handle) {
	696	lttng_destroy_handle(handle);
	697	}
cd80958d DG	698
	699	handle = lttng_create_handle(session_name, &domains[i]);
	700	if (handle == NULL) {
ca1c3607	701	ret = CMD_FATAL;
cd80958d DG	702	goto end;
	703	}
	704
	705	ret = list_channels(opt_channel);
9f19cc17 DG	706	if (ret < 0) {
	707	goto end;
	708	}
	709	}
	710	}
f3ed775e DG	711	}
	712
	713	end:
9f19cc17 DG	714	if (domains) {
	715	free(domains);
	716	}
aa5de748 MD	717	if (handle) {
	718	lttng_destroy_handle(handle);
	719	}
cd80958d	720
ca1c3607	721	poptFreeContext(pc);
f3ed775e DG	722	return ret;
f3ed775e DG	723	}