#include <string.h>
#include <unistd.h>
-#include <lttng/liblttngctl.h>
+#include <lttng/lttng.h>
#include "liblttsessiondcomm.h"
#include "lttngerr.h"
static char sessiond_sock_path[PATH_MAX];
/* Communication structure to ltt-sessiond */
-static struct lttcomm_lttng_msg llm;
static struct lttcomm_session_msg lsm;
-
-/* Prototypes */
-static int check_tracing_group(const char *grp_name);
-static int ask_sessiond(void);
-static int set_session_daemon_path(void);
-static void reset_data_struct(void);
-
-int lttng_connect_sessiond(void);
-int lttng_create_session(const char *name, char *session_id);
-int lttng_check_session_daemon(void);
+static struct lttcomm_lttng_msg llm;
/* Variables */
static char *tracing_group;
static int connected;
/*
- * ask_sessiond
+ * send_data_sessiond
*
- * Send lttcomm_session_msg to the daemon and wait
- * for the reply. Data replied will be put in llm
+ * Send lttcomm_session_msg to the session daemon.
*
* On success, return 0
* On error, return error code
*/
-static int ask_sessiond(void)
+static int send_data_sessiond(void)
{
int ret;
if (!connected) {
- ret = -ECONNREFUSED;
- goto error;
+ 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 error;
+ goto end;
}
- ret = lttcomm_recv_unix_sock(sessiond_socket, &llm, sizeof(llm));
+ lsm.cmd_type = lct;
+
+ /* Send command to session daemon */
+ ret = send_data_sessiond();
if (ret < 0) {
- goto error;
+ goto end;
}
- /* Check return code */
+ /* 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 error;
+ goto end;
}
- return 0;
+ size = llm.trace_name_offset + llm.data_size;
+ if (size == 0) {
+ goto end;
+ }
-error:
+ 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;
}
/*
- * lttng_get_readable_code
+ * check_tracing_group
*
- * Return a human readable string of code
+ * Check if the specified group name exist.
+ * If yes, 0, else -1
*/
-const char *lttng_get_readable_code(int code)
+static int check_tracing_group(const char *grp_name)
{
- if (code > -LTTCOMM_OK) {
- return "Ended with errors";
+ 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;
}
- return lttcomm_get_readable_code(code);
+ /* 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;
}
/*
- * lttng_create_session
- *
- * Create a tracing session using "name" to the session daemon.
- * If no name is given, the auto session creation is set and
- * the daemon will take care of finding a name.
+ * set_session_daemon_path
*
- * On success, return 0 and session_id point to the uuid str.
- * On error, negative value is returned.
+ * Set sessiond socket path by putting it in
+ * the global sessiond_sock_path variable.
*/
-int lttng_create_session(const char *name, char *session_id)
+static int set_session_daemon_path(void)
{
int ret;
- lsm.cmd_type = LTTNG_CREATE_SESSION;
- if (name == NULL) {
- lsm.u.create_session.auto_session = 1;
+ /* 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(lsm.session_name, name, strlen(name));
- lsm.u.create_session.auto_session = 0;
+ strncpy(sessiond_sock_path, DEFAULT_GLOBAL_CLIENT_UNIX_SOCK,
+ sizeof(DEFAULT_GLOBAL_CLIENT_UNIX_SOCK));
}
- /* Ask the session daemon */
- ret = ask_sessiond();
- if (ret < 0) {
- goto end;
- }
+ return 0;
+}
- /* Unparse session ID */
- uuid_unparse(llm.session_id, session_id);
+/*
+ * BEGIN KERNEL CONTROL
+ */
-end:
- reset_data_struct();
+/*
+ * lttng_kernel_enable_event
+ *
+ * Enable an event in the kernel tracer.
+ */
+int lttng_kernel_enable_event(char *event_name)
+{
+ int ret;
+
+ if (event_name == NULL) {
+ ret = ask_sessiond(KERNEL_ENABLE_ALL_EVENT, NULL);
+ } else {
+ strncpy(lsm.u.event.event_name, event_name, NAME_MAX);
+ ret = ask_sessiond(KERNEL_ENABLE_EVENT, NULL);
+ }
return ret;
}
/*
- * lttng_ust_list_apps
+ * lttng_kernel_disable_event
*
- * Ask the session daemon for all UST traceable
- * applications.
+ * Disable an event in the kernel tracer.
+ */
+int lttng_kernel_disable_event(char *event_name)
+{
+ strncpy(lsm.u.event.event_name, event_name, NAME_MAX);
+ return ask_sessiond(KERNEL_DISABLE_EVENT, NULL);
+}
+
+/*
+ * lttng_kernel_create_session
*
- * Return the size of pids.
+ * Create a session in the kernel tracer.
*/
-size_t lttng_ust_list_apps(pid_t **pids)
+int lttng_kernel_create_session(void)
{
- int ret;
+ return ask_sessiond(KERNEL_CREATE_SESSION, NULL);
+}
- lsm.cmd_type = UST_LIST_APPS;
+/*
+ * lttng_kernel_create_channel
+ *
+ * Create a channel in the kernel tracer.
+ */
+int lttng_kernel_create_channel(void)
+{
+ return ask_sessiond(KERNEL_CREATE_CHANNEL, NULL);
+}
- ret = ask_sessiond();
- if (ret < 0) {
- goto error;
+/*
+ * lttng_kernel_open_metadata
+ *
+ * Open metadata in the kernel tracer.
+ */
+int lttng_kernel_open_metadata(void)
+{
+ return ask_sessiond(KERNEL_OPEN_METADATA, NULL);
+}
+
+/*
+ * lttng_kernel_create_stream
+ *
+ * Create stream in the kernel tracer.
+ */
+int lttng_kernel_create_stream(void)
+{
+ return ask_sessiond(KERNEL_CREATE_STREAM, NULL);
+}
+
+/*
+ * lttng_kernel_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(KERNEL_LIST_EVENTS, (void **) event_list);
+}
+
+/*
+ * lttng_kernel_start_tracing
+ *
+ * Start kernel tracing.
+ */
+int lttng_kernel_start_tracing(void)
+{
+ return ask_sessiond(KERNEL_START_TRACE, NULL);
+}
+
+/*
+ * lttng_kernel_stop_tracing
+ *
+ * Stop kernel tracing.
+ */
+int lttng_kernel_stop_tracing(void)
+{
+ return ask_sessiond(KERNEL_STOP_TRACE, NULL);
+}
+
+/*
+ * END KERNEL CONTROL
+ */
+
+/*
+ * 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";
}
- *pids = llm.u.list_apps.pids;
+ return lttcomm_get_readable_code(code);
+}
+
+/*
+ * lttng_ust_start_trace
+ *
+ * Request a trace start for pid.
+ */
+int lttng_ust_start_trace(pid_t pid)
+{
+ lsm.pid = pid;
+ return ask_sessiond(UST_START_TRACE, NULL);
+}
- return llm.u.list_apps.size;
+/*
+ * lttng_ust_stop_trace
+ *
+ * Request a trace stop for pid.
+ */
+int lttng_ust_stop_trace(pid_t pid)
+{
+ lsm.pid = pid;
+ return ask_sessiond(UST_STOP_TRACE, NULL);
+}
-error:
- return ret;
+/*
+ * lttng_ust_create_trace
+ *
+ * Request a trace creation for pid.
+ */
+int lttng_ust_create_trace(pid_t pid)
+{
+ lsm.pid = pid;
+ return ask_sessiond(UST_CREATE_TRACE, NULL);
}
/*
- * lttng_connect_sessiond
+ * lttng_ust_list_apps
*
- * Connect to the LTTng session daemon.
- * On success, return 0
- * On error, return a negative value
+ * Ask the session daemon for all UST traceable applications.
+ *
+ * Return the number of pids.
+ * On error, return negative value.
*/
-int lttng_connect_sessiond(void)
+int lttng_ust_list_apps(pid_t **pids)
{
int ret;
- ret = set_session_daemon_path();
+ ret = ask_sessiond(UST_LIST_APPS, (void**) pids);
if (ret < 0) {
return ret;
}
- /* Connect to the sesssion daemon */
- ret = lttcomm_connect_unix_sock(sessiond_sock_path);
+ return ret / sizeof(pid_t);
+}
+
+/*
+ * lttng_list_traces
+ *
+ * Ask the session daemon for all traces (kernel and ust) for the session
+ * identified by uuid.
+ *
+ * Return the number of traces.
+ * On error, return negative value.
+ */
+int lttng_list_traces(uuid_t *uuid, struct lttng_trace **traces)
+{
+ int ret;
+
+ uuid_copy(lsm.session_uuid, *uuid);
+
+ ret = ask_sessiond(LTTNG_LIST_TRACES, (void **) traces);
if (ret < 0) {
return ret;
}
- sessiond_socket = ret;
- connected = 1;
+ return ret / sizeof(struct lttng_trace);
+}
- return 0;
+/*
+ * lttng_create_session
+ *
+ * Create a brand new session using name.
+ */
+int lttng_create_session(char *name)
+{
+ strncpy(lsm.session_name, name, NAME_MAX);
+ return ask_sessiond(LTTNG_CREATE_SESSION, NULL);
}
/*
- * lttng_set_tracing_group
+ * lttng_destroy_session
*
- * Set tracing group variable with name. This function
- * allocate memory pointed by tracing_group.
+ * Destroy session using name.
*/
-int lttng_set_tracing_group(const char *name)
+int lttng_destroy_session(uuid_t *uuid)
{
- if (asprintf(&tracing_group, "%s", name) < 0) {
- return -ENOMEM;
+ uuid_copy(lsm.session_uuid, *uuid);
+ 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 0;
+ return ret / sizeof(struct lttng_session);
}
/*
- * lttng_check_session_daemon
+ * lttng_connect_sessiond
*
- * Return 0 if a sesssion daemon is available
- * else return -1
+ * Connect to the LTTng session daemon.
+ * On success, return 0
+ * On error, return a negative value
*/
-int lttng_check_session_daemon(void)
+int lttng_connect_sessiond(void)
{
int ret;
return ret;
}
- /* If socket exist, we consider the daemon started */
- ret = access(sessiond_sock_path, F_OK);
+ /* 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;
}
/*
- * reset_data_struct
+ * lttng_disconnect_sessiond
*
- * Reset session daemon structures.
+ * Clean disconnect the session daemon.
*/
-static void reset_data_struct(void)
+int lttng_disconnect_sessiond(void)
{
- memset(&lsm, 0, sizeof(lsm));
- memset(&llm, 0, sizeof(llm));
+ int ret = 0;
+
+ if (connected) {
+ ret = lttcomm_close_unix_sock(sessiond_socket);
+ sessiond_socket = 0;
+ connected = 0;
+ }
+
+ return ret;
}
/*
- * set_session_daemon_path
+ * lttng_set_current_session_uuid
*
- * Set sessiond socket path by putting it in
- * the global sessiond_sock_path variable.
+ * Set the session uuid for current lsm.
*/
-static int set_session_daemon_path(void)
+void lttng_set_current_session_uuid(uuid_t *uuid)
{
- int ret;
+ uuid_copy(lsm.session_uuid, *uuid);
+}
- /* Are we in the tracing group ? */
- ret = check_tracing_group(tracing_group);
- if (ret < 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));
+/*
+ * 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;
}
/*
- * check_tracing_group
+ * lttng_check_session_daemon
*
- * Check if the specified group name exist.
- * If yes, 0, else -1
+ * Yes, return 1
+ * No, return 0
+ * Error, return negative value
*/
-static int check_tracing_group(const char *grp_name)
+int lttng_session_daemon_alive(void)
{
- 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;
- }
+ int ret;
- /* 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;
+ ret = set_session_daemon_path();
+ if (ret < 0) {
+ /* Error */
+ return ret;
}
- for (i = 0; i < grp_list_size; i++) {
- if (grp_list[i] == grp_tracing->gr_gid) {
- ret = 0;
- break;
- }
+ /* If socket exist, we consider the daemon started */
+ ret = access(sessiond_sock_path, F_OK);
+ if (ret < 0) {
+ /* Not alive */
+ return 0;
}
-free_list:
- free(grp_list);
-
-end:
- return ret;
+ /* Is alive */
+ return 1;
}
/*
static void __attribute__((constructor)) init()
{
/* Set default session group */
- lttng_set_tracing_group(DEFAULT_TRACING_GROUP);
+ lttng_set_tracing_group(LTTNG_DEFAULT_TRACING_GROUP);
}