[lttng-tools.git] / liblttngctl / liblttngctl.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
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * 
 * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */

#define _GNU_SOURCE
#include <errno.h>
#include <grp.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

#include <lttng/lttng.h>

#include "liblttsessiondcomm.h"
#include "lttngerr.h"
#include "lttng-share.h"

/* Socket to session daemon for communication */
static int sessiond_socket;
static char sessiond_sock_path[PATH_MAX];

/* Communication structure to ltt-sessiond */
static struct lttcomm_session_msg lsm;
static struct lttcomm_lttng_msg llm;

/* Variables */
static char *tracing_group;
static int connected;

/*
 *  send_data_sessiond
 *
 *  Send lttcomm_session_msg to the session daemon.
 *
 *  On success, return 0
 *  On error, return error code
 */
static int send_data_sessiond(void)
{
	int ret;

	if (!connected) {
		ret = -ENOTCONN;
		goto end;
	}

	ret = lttcomm_send_unix_sock(sessiond_socket, &lsm, sizeof(lsm));

end:
	return ret;
}

/*
 *  recv_data_sessiond
 *
 *  Receive data from the sessiond socket.
 *
 *  On success, return 0
 *  On error, return recv() error code
 */
static int recv_data_sessiond(void *buf, size_t len)
{
	int ret;

	if (!connected) {
		ret = -ENOTCONN;
		goto end;
	}

	ret = lttcomm_recv_unix_sock(sessiond_socket, buf, len);

end:
	return ret;
}

/*
 *  ask_sessiond
 *
 *  Ask the session daemon a specific command and put the data into buf.
 *
 *  Return size of data (only payload, not header).
 */
static int ask_sessiond(enum lttcomm_sessiond_command lct, void **buf)
{
	int ret;
	size_t size;
	void *data = NULL;

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

	lsm.cmd_type = lct;

	/* Send command to session daemon */
	ret = send_data_sessiond();
	if (ret < 0) {
		goto end;
	}

	/* Get header from data transmission */
	ret = recv_data_sessiond(&llm, sizeof(llm));
	if (ret < 0) {
		goto end;
	}

	/* Check error code if OK */
	if (llm.ret_code != LTTCOMM_OK) {
		ret = -llm.ret_code;
		goto end;
	}

	size = llm.data_size;
	if (size == 0) {
		goto end;
	}

	data = (void*) malloc(size);

	/* Get payload data */
	ret = recv_data_sessiond(data, size);
	if (ret < 0) {
		free(data);
		goto end;
	}

	*buf = data;
	ret = size;

end:
	lttng_disconnect_sessiond();
	return ret;
}

/*
 *  check_tracing_group
 *
 *  Check if the specified group name exist.
 *  If yes, 0, else -1
 */
static int check_tracing_group(const char *grp_name)
{
	struct group *grp_tracing;	/* no free(). See getgrnam(3) */
	gid_t *grp_list;
	int grp_list_size, grp_id, i;
	int ret = -1;

	/* Get GID of group 'tracing' */
	grp_tracing = getgrnam(grp_name);
	if (grp_tracing == NULL) {
		/* NULL means not found also. getgrnam(3) */
		if (errno != 0) {
			perror("getgrnam");
		}
		goto end;
	}

	/* Get number of supplementary group IDs */
	grp_list_size = getgroups(0, NULL);
	if (grp_list_size < 0) {
		perror("getgroups");
		goto end;
	}

	/* Alloc group list of the right size */
	grp_list = malloc(grp_list_size * sizeof(gid_t));
	grp_id = getgroups(grp_list_size, grp_list);
	if (grp_id < -1) {
		perror("getgroups");
		goto free_list;
	}

	for (i = 0; i < grp_list_size; i++) {
		if (grp_list[i] == grp_tracing->gr_gid) {
			ret = 0;
			break;
		}
	}

free_list:
	free(grp_list);

end:
	return ret;
}

/*
 *  set_session_daemon_path
 *
 *  Set sessiond socket path by putting it in 
 *  the global sessiond_sock_path variable.
 */
static int set_session_daemon_path(void)
{
	int ret;

	/* Are we in the tracing group ? */
	ret = check_tracing_group(tracing_group);
	if (ret < 0 && getuid() != 0) {
		if (sprintf(sessiond_sock_path, DEFAULT_HOME_CLIENT_UNIX_SOCK,
					getenv("HOME")) < 0) {
			return -ENOMEM;
		}
	} else {
		strncpy(sessiond_sock_path, DEFAULT_GLOBAL_CLIENT_UNIX_SOCK,
				sizeof(DEFAULT_GLOBAL_CLIENT_UNIX_SOCK));
	}

	return 0;
}

/*
 *  lttng_start_tracing
 *
 *  Start tracing for all trace of the session.
 */
int lttng_start_tracing(char *session_name)
{
	strncpy(lsm.session_name, session_name, NAME_MAX);
	return ask_sessiond(LTTNG_START_TRACE, NULL);
}

/*
 *  lttng_stop_tracing
 *
 *  Stop tracing for all trace of the session.
 */
int lttng_stop_tracing(char *session_name)
{
	strncpy(lsm.session_name, session_name, NAME_MAX);
	return ask_sessiond(LTTNG_STOP_TRACE, NULL);
}

/*
 * BEGIN Kernel control API
 */

/*
 *  lttng_kernel_enable_event
 */
int lttng_kernel_enable_event(struct lttng_event *ev, char *channel_name)
{
	int ret;

	if (strlen(channel_name) == 0) {
		strncpy(lsm.u.enable.channel_name, DEFAULT_CHANNEL_NAME, NAME_MAX);
	} else {
		strncpy(lsm.u.enable.channel_name, channel_name, NAME_MAX);
	}

	if (ev == NULL) {
		ret = ask_sessiond(LTTNG_KERNEL_ENABLE_ALL_EVENT, NULL);
	} else {
		memcpy(&lsm.u.enable.event, ev, sizeof(struct lttng_event));
		ret = ask_sessiond(LTTNG_KERNEL_ENABLE_EVENT, NULL);
	}

	return ret;
}

/*
 *  lttng_kernel_disable_event
 *
 *  Disable an event in the kernel tracer.
 */
int lttng_kernel_disable_event(char *name, char *channel_name)
{
	int ret;

	if (strlen(channel_name) == 0) {
		strncpy(lsm.u.disable.channel_name, DEFAULT_CHANNEL_NAME, NAME_MAX);
	} else {
		strncpy(lsm.u.disable.channel_name, channel_name, NAME_MAX);
	}

	if (name == NULL) {
		ret = ask_sessiond(LTTNG_KERNEL_DISABLE_ALL_EVENT, NULL);
	} else {
		strncpy(lsm.u.disable.name, name, NAME_MAX);
		ret = ask_sessiond(LTTNG_KERNEL_DISABLE_EVENT, NULL);
	}

	return ret;
}

/*
 *  lttng_kernel_enable_channel
 *
 *  Enable recording for a channel for the kernel tracer.
 */
int lttng_kernel_enable_channel(char *name)
{
	strncpy(lsm.u.enable.channel_name, name, NAME_MAX);
	return ask_sessiond(LTTNG_KERNEL_ENABLE_CHANNEL, NULL);
}

/*
 *  lttng_kernel_disable_channel
 *
 *  Disable recording for the channel for the kernel tracer.
 */
int lttng_kernel_disable_channel(char *name)
{
	strncpy(lsm.u.disable.channel_name, name, NAME_MAX);
	return ask_sessiond(LTTNG_KERNEL_DISABLE_CHANNEL, NULL);
}

/*
 *  lttng_kernel_create_channel
 *
 *  Create a channel in the kernel tracer.
 */
int lttng_kernel_create_channel(struct lttng_channel *chan)
{
	memcpy(&lsm.u.channel.chan, chan, sizeof(struct lttng_channel));
	return ask_sessiond(LTTNG_KERNEL_CREATE_CHANNEL, NULL);
}

/*
 *  lttng_list_events
 *
 *  List all available events in the kernel.
 *
 *  Return the size (bytes) of the list and set the event_list array.
 *  On error, return negative value.
 */
int lttng_kernel_list_events(char **event_list)
{
	return ask_sessiond(LTTNG_KERNEL_LIST_EVENTS, (void **) event_list);
}

/*
 * END Kernel control API
 */

/*
 *  lttng_get_readable_code
 *
 *  Return a human readable string of code
 */
const char *lttng_get_readable_code(int code)
{
	if (code > -LTTCOMM_OK) {
		return "Ended with errors";
	}

	return lttcomm_get_readable_code(code);
}

/*
 *  lttng_ust_list_apps
 *
 *  Ask the session daemon for all UST traceable applications.
 *
 *  Return the number of pids.
 *  On error, return negative value.
 */
int lttng_ust_list_traceable_apps(pid_t **pids)
{
	int ret;

	ret = ask_sessiond(LTTNG_LIST_TRACEABLE_APPS, (void**) pids);
	if (ret < 0) {
		return ret;
	}

	return ret / sizeof(pid_t);
}

/*
 *  lttng_list_traces
 *
 *  Ask the session daemon for all traces (kernel and ust) for the session
 *  identified by name.
 *
 *  Return the number of traces.
 *  On error, return negative value.
 */
/*
int lttng_list_traces(char *session_name, struct lttng_trace **traces)
{
	int ret;

	strncpy(lsm.session_name, session_name, NAME_MAX);

	ret = ask_sessiond(LTTNG_LIST_TRACES, (void **) traces);
	if (ret < 0) {
		return ret;
	}

	return ret / sizeof(struct lttng_trace);
}
*/

/*
 *  lttng_create_session
 *
 *  Create a brand new session using name.
 */
int lttng_create_session(char *name, char *path)
{
	strncpy(lsm.session_name, name, NAME_MAX);
	strncpy(lsm.path, path, PATH_MAX);
	return ask_sessiond(LTTNG_CREATE_SESSION, NULL);
}

/*
 *  lttng_destroy_session
 *
 *  Destroy session using name.
 */
int lttng_destroy_session(char *name)
{
	strncpy(lsm.session_name, name, NAME_MAX);
	return ask_sessiond(LTTNG_DESTROY_SESSION, NULL);
}

/*
 *  lttng_list_sessions
 *
 *  Ask the session daemon for all available sessions.
 *
 *  Return number of session.
 *  On error, return negative value.
 */
int lttng_list_sessions(struct lttng_session **sessions)
{
	int ret;

	ret = ask_sessiond(LTTNG_LIST_SESSIONS, (void**) sessions);
	if (ret < 0) {
		return ret;
	}

	return ret / sizeof(struct lttng_session);
}

/*
 *  lttng_connect_sessiond
 *
 *  Connect to the LTTng session daemon.
 *  On success, return 0
 *  On error, return a negative value
 */
int lttng_connect_sessiond(void)
{
	int ret;

	ret = set_session_daemon_path();
	if (ret < 0) {
		return ret;
	}

	/* Connect to the sesssion daemon */
	ret = lttcomm_connect_unix_sock(sessiond_sock_path);
	if (ret < 0) {
		return ret;
	}

	sessiond_socket = ret;
	connected = 1;

	return 0;
}

/*
 *  lttng_disconnect_sessiond
 *
 *  Clean disconnect the session daemon.
 */
int lttng_disconnect_sessiond(void)
{
	int ret = 0;

	if (connected) {
		ret = lttcomm_close_unix_sock(sessiond_socket);
		sessiond_socket = 0;
		connected = 0;
	}

	return ret;
}

void lttng_set_session_name(char *name)
{
	strncpy(lsm.session_name, name, NAME_MAX);
}

/*
 *  lttng_set_tracing_group
 *
 *  Set tracing group variable with name. This function
 *  allocate memory pointed by tracing_group.
 */
int lttng_set_tracing_group(const char *name)
{
	if (asprintf(&tracing_group, "%s", name) < 0) {
		return -ENOMEM;
	}

	return 0;
}

/*
 *  lttng_check_session_daemon
 *
 *  Yes, return 1
 *  No, return 0
 *  Error, return negative value
 */
int lttng_session_daemon_alive(void)
{
	int ret;

	ret = set_session_daemon_path();
	if (ret < 0) {
		/* Error */
		return ret;
	}

	/* If socket exist, we consider the daemon started */
	ret = access(sessiond_sock_path, F_OK);
	if (ret < 0) {
		/* Not alive */
		return 0;
	}

	/* Is alive */
	return 1;
}

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