[lttng-tools.git] / src / common / error.cpp

/*
 * Copyright (C) 2012 David Goulet <dgoulet@efficios.com>
 *
 * SPDX-License-Identifier: LGPL-2.1-only
 *
 */

#define _LGPL_SOURCE
#include <inttypes.h>
#include <pthread.h>
#include <stdlib.h>
#include <string.h>

#include <common/common.h>
#include <common/thread.h>
#include <common/compat/errno.h>
#include <common/compat/getenv.h>
#include <lttng/lttng-error.h>

#include "error.h"

/*
 * lttng_opt_abort_on_error: unset: -1, disabled: 0, enabled: 1.
 * Controlled by the LTTNG_ABORT_ON_ERROR environment variable.
 */
static int lttng_opt_abort_on_error = -1;

/* TLS variable that contains the time of one single log entry. */
DEFINE_URCU_TLS(struct log_time, error_log_time);
DEFINE_URCU_TLS(const char *, logger_thread_name);

const char *log_add_time(void)
{
	int ret;
	struct tm tm, *res;
	struct timespec tp;
	time_t now;
	const int errsv = errno;

	ret = lttng_clock_gettime(CLOCK_REALTIME, &tp);
	if (ret < 0) {
		goto error;
	}
	now = (time_t) tp.tv_sec;

	res = localtime_r(&now, &tm);
	if (!res) {
		goto error;
	}

	/* Format time in the TLS variable. */
	ret = snprintf(URCU_TLS(error_log_time).str, sizeof(URCU_TLS(error_log_time).str),
			"%02d:%02d:%02d.%09ld",
			tm.tm_hour, tm.tm_min, tm.tm_sec, tp.tv_nsec);
	if (ret < 0) {
		goto error;
	}

	errno = errsv;
	return URCU_TLS(error_log_time).str;

error:
	/* Return an empty string on error so logging is not affected. */
	errno = errsv;
	return "";
}

void logger_set_thread_name(const char *name, bool set_pthread_name)
{
	int ret;

	LTTNG_ASSERT(name);
	URCU_TLS(logger_thread_name) = name;

	if (set_pthread_name) {
		ret = lttng_thread_setname(name);
		if (ret && ret != -ENOSYS) {
			/* Don't fail as this is not essential. */
			DBG("Failed to set pthread name attribute");
		}
	}
}

/*
 * Human readable error message.
 */
static
const char *lttng_error_code_str(lttng_error_code code)
{
	switch (code) {
	case LTTNG_OK:
		return "Success";
	case LTTNG_ERR_UNK:
		return "Unknown error";
	case LTTNG_ERR_UND:
		return "Undefined command";
	case LTTNG_ERR_UNKNOWN_DOMAIN:
		return "Unknown tracing domain";
	case LTTNG_ERR_NO_SESSION:
		return "No session found";
	case LTTNG_ERR_CREATE_DIR_FAIL:
		return "Create directory failed";
	case LTTNG_ERR_SESSION_FAIL:
		return "Create session failed";
	case LTTNG_ERR_SESS_NOT_FOUND:
		return "Session name not found";
	case LTTNG_ERR_FATAL:
		return "Fatal error of the session daemon";
	case LTTNG_ERR_SELECT_SESS:
		return "A session MUST be selected";
	case LTTNG_ERR_EXIST_SESS:
		return "Session name already exists";
	case LTTNG_ERR_NO_EVENT:
		return "Event not found";
	case LTTNG_ERR_CONNECT_FAIL:
		return "Unable to connect to Unix socket";
	case LTTNG_ERR_EPERM:
		return "Permission denied";
	case LTTNG_ERR_KERN_NA:
		return "Kernel tracer not available";
	case LTTNG_ERR_KERN_VERSION:
		return "Kernel tracer version is not compatible";
	case LTTNG_ERR_KERN_EVENT_EXIST:
		return "Kernel event already exists";
	case LTTNG_ERR_KERN_SESS_FAIL:
		return "Kernel create session failed";
	case LTTNG_ERR_KERN_CHAN_EXIST:
		return "Kernel channel already exists";
	case LTTNG_ERR_KERN_CHAN_FAIL:
		return "Kernel create channel failed";
	case LTTNG_ERR_KERN_CHAN_NOT_FOUND:
		return "Kernel channel not found";
	case LTTNG_ERR_KERN_CHAN_DISABLE_FAIL:
		return "Disable kernel channel failed";
	case LTTNG_ERR_KERN_CHAN_ENABLE_FAIL:
		return "Enable kernel channel failed";
	case LTTNG_ERR_KERN_CONTEXT_FAIL:
		return "Add kernel context failed";
	case LTTNG_ERR_KERN_ENABLE_FAIL:
		return "Enable kernel event failed";
	case LTTNG_ERR_KERN_DISABLE_FAIL:
		return "Disable kernel event failed";
	case LTTNG_ERR_KERN_META_FAIL:
		return "Opening metadata failed";
	case LTTNG_ERR_KERN_START_FAIL:
		return "Starting kernel trace failed";
	case LTTNG_ERR_KERN_STOP_FAIL:
		return "Stopping kernel trace failed";
	case LTTNG_ERR_KERN_CONSUMER_FAIL:
		return "Kernel consumer start failed";
	case LTTNG_ERR_KERN_STREAM_FAIL:
		return "Kernel create stream failed";
	case LTTNG_ERR_KERN_LIST_FAIL:
		return "Listing kernel events failed";
	case LTTNG_ERR_UST_CALIBRATE_FAIL:
		return "UST calibration failed";
	case LTTNG_ERR_UST_SESS_FAIL:
		return "UST create session failed";
	case LTTNG_ERR_UST_CHAN_FAIL:
		return "UST create channel failed";
	case LTTNG_ERR_UST_CHAN_EXIST:
		return "UST channel already exist";
	case LTTNG_ERR_UST_CHAN_NOT_FOUND:
		return "UST channel not found";
	case LTTNG_ERR_UST_CHAN_DISABLE_FAIL:
		return "Disable UST channel failed";
	case LTTNG_ERR_UST_CHAN_ENABLE_FAIL:
		return "Enable UST channel failed";
	case LTTNG_ERR_UST_ENABLE_FAIL:
		return "Enable UST event failed";
	case LTTNG_ERR_UST_DISABLE_FAIL:
		return "Disable UST event failed";
	case LTTNG_ERR_UST_META_FAIL:
		return "Opening metadata failed";
	case LTTNG_ERR_UST_START_FAIL:
		return "Starting UST trace failed";
	case LTTNG_ERR_UST_STOP_FAIL:
		return "Stopping UST trace failed";
	case LTTNG_ERR_UST_CONSUMER64_FAIL:
		return "64-bit UST consumer start failed";
	case LTTNG_ERR_UST_CONSUMER32_FAIL:
		return "32-bit UST consumer start failed";
	case LTTNG_ERR_UST_STREAM_FAIL:
		return "UST create stream failed";
	case LTTNG_ERR_UST_LIST_FAIL:
		return "Listing UST events failed";
	case LTTNG_ERR_UST_EVENT_EXIST:
		return "UST event already exist";
	case LTTNG_ERR_UST_EVENT_NOT_FOUND:
		return "UST event not found";
	case LTTNG_ERR_UST_CONTEXT_EXIST:
		return "UST context already exist";
	case LTTNG_ERR_UST_CONTEXT_INVAL:
		return "UST invalid context";
	case LTTNG_ERR_NEED_ROOT_SESSIOND:
		return "Tracing the kernel requires a root lttng-sessiond daemon, as well as \"tracing\" group membership or root user ID for the lttng client";
	case LTTNG_ERR_NO_UST:
		return "LTTng-UST tracer is not supported. Please rebuild lttng-tools with lttng-ust support enabled";
	case LTTNG_ERR_TRACE_ALREADY_STARTED:
		return "Tracing has already been started once";
	case LTTNG_ERR_TRACE_ALREADY_STOPPED:
		return "Tracing has already been stopped";
	case LTTNG_ERR_KERN_EVENT_ENOSYS:
		return "Kernel event type not supported";
	case LTTNG_ERR_NEED_CHANNEL_NAME:
		return "Non-default channel exists within session: channel name needs to be specified with '-c name'";
	case LTTNG_ERR_INVALID:
		return "Invalid parameter";
	case LTTNG_ERR_NO_USTCONSUMERD:
		return "No UST consumer detected";
	case LTTNG_ERR_NO_KERNCONSUMERD:
		return "No kernel consumer detected";
	case LTTNG_ERR_EVENT_EXIST_LOGLEVEL:
		return "Event already enabled with different loglevel";
	case LTTNG_ERR_URL_DATA_MISS:
		return "Missing data path URL";
	case LTTNG_ERR_URL_CTRL_MISS:
		return "Missing control path URL";
	case LTTNG_ERR_ENABLE_CONSUMER_FAIL:
		return "Enabling consumer failed";
	case LTTNG_ERR_RELAYD_CONNECT_FAIL:
		return "Unable to connect to lttng-relayd";
	case LTTNG_ERR_RELAYD_VERSION_FAIL:
		return "Relay daemon not compatible";
	case LTTNG_ERR_FILTER_INVAL:
		return "Invalid filter bytecode";
	case LTTNG_ERR_FILTER_NOMEM:
		return "Not enough memory for filter bytecode";
	case LTTNG_ERR_FILTER_EXIST:
		return "Filter already exist";
	case LTTNG_ERR_NO_CONSUMER:
		return "Consumer not found for recording session";
	case LTTNG_ERR_EXCLUSION_INVAL:
		return "Invalid event exclusion data";
	case LTTNG_ERR_EXCLUSION_NOMEM:
		return "Lack of memory while processing event exclusions";
	case LTTNG_ERR_NO_SESSIOND:
		return "No session daemon is available";
	case LTTNG_ERR_SESSION_STARTED:
		return "Session is running";
	case LTTNG_ERR_NOT_SUPPORTED:
		return "Operation not supported";
	case LTTNG_ERR_UST_EVENT_ENABLED:
		return "UST event already enabled";
	case LTTNG_ERR_SET_URL:
		return "Error setting URL";
	case LTTNG_ERR_URL_EXIST:
		return "URL already exists";
	case LTTNG_ERR_BUFFER_NOT_SUPPORTED:
		return "Buffer type not supported";
	case LTTNG_ERR_BUFFER_TYPE_MISMATCH:
		return "Buffer type mismatch for session";
	case LTTNG_ERR_NOMEM:
		return "Not enough memory";
	case LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST:
		return "Snapshot output already exists";
	case LTTNG_ERR_START_SESSION_ONCE:
		return "Session needs to be started once";
	case LTTNG_ERR_SNAPSHOT_FAIL:
		return "Snapshot record failed";
	case LTTNG_ERR_NO_STREAM:
		return "Index without stream on relay";
	case LTTNG_ERR_CHAN_EXIST:
		return "Channel already exists";
	case LTTNG_ERR_SNAPSHOT_NODATA:
		return "No data available in snapshot";
	case LTTNG_ERR_NO_CHANNEL:
		return "No channel found in the session";
	case LTTNG_ERR_SESSION_INVALID_CHAR:
		return "Invalid character found in session name";
	case LTTNG_ERR_SAVE_FILE_EXIST:
		return "Session file already exists";
	case LTTNG_ERR_SAVE_IO_FAIL:
		return "IO error while writing session configuration";
	case LTTNG_ERR_LOAD_INVALID_CONFIG:
		return "Invalid session configuration";
	case LTTNG_ERR_LOAD_IO_FAIL:
		return "IO error while reading a session configuration";
	case LTTNG_ERR_LOAD_SESSION_NOENT:
		return "Session file not found";
	case LTTNG_ERR_MAX_SIZE_INVALID:
		return "Snapshot max size is invalid";
	case LTTNG_ERR_MI_OUTPUT_TYPE:
		return "Invalid MI output format";
	case LTTNG_ERR_MI_IO_FAIL:
		return "IO error while writing MI output";
	case LTTNG_ERR_MI_NOT_IMPLEMENTED:
		return "Mi feature not implemented";
	case LTTNG_ERR_INVALID_EVENT_NAME:
		return "Invalid event name";
	case LTTNG_ERR_INVALID_CHANNEL_NAME:
		return "Invalid channel name";
	case LTTNG_ERR_PROCESS_ATTR_EXISTS:
		return "Process attribute is already tracked";
	case LTTNG_ERR_PROCESS_ATTR_MISSING:
		return "Process attribute was not tracked";
	case LTTNG_ERR_INVALID_CHANNEL_DOMAIN:
		return "Invalid channel domain";
	case LTTNG_ERR_OVERFLOW:
		return "Overflow occurred";
	case LTTNG_ERR_SESSION_NOT_STARTED:
		return "Session not started";
	case LTTNG_ERR_LIVE_SESSION:
		return "Live sessions are not supported";
	case LTTNG_ERR_PER_PID_SESSION:
		return "Per-PID recording sessions are not supported";
	case LTTNG_ERR_KERN_CONTEXT_UNAVAILABLE:
		return "Context unavailable on this kernel";
	case LTTNG_ERR_REGEN_STATEDUMP_FAIL:
		return "Failed to regenerate the state dump";
	case LTTNG_ERR_REGEN_STATEDUMP_NOMEM:
		return "Failed to regenerate the state dump, not enough memory";
	case LTTNG_ERR_NOT_SNAPSHOT_SESSION:
		return "Snapshot command can't be applied to a non-snapshot session";
	case LTTNG_ERR_INVALID_TRIGGER:
		return "Invalid trigger";
	case LTTNG_ERR_TRIGGER_EXISTS:
		return "Trigger already registered";
	case LTTNG_ERR_TRIGGER_NOT_FOUND:
		return "Trigger not found";
	case LTTNG_ERR_COMMAND_CANCELLED:
		return "Command cancelled";
	case LTTNG_ERR_ROTATION_PENDING:
		return "Rotation already pending for this session";
	case LTTNG_ERR_ROTATION_NOT_AVAILABLE:
		return "Rotation feature not available for this session's creation mode";
	case LTTNG_ERR_ROTATION_SCHEDULE_SET:
		return "A session rotation schedule of this type is already set on the session";
	case LTTNG_ERR_ROTATION_SCHEDULE_NOT_SET:
		return "No session rotation schedule of this type is set on the session";
	case LTTNG_ERR_ROTATION_MULTIPLE_AFTER_STOP:
		return "Session was already rotated once since it became inactive";
	case LTTNG_ERR_ROTATION_WRONG_VERSION:
		return "Session rotation is not supported by this kernel tracer version";
	case LTTNG_ERR_NO_SESSION_OUTPUT:
		return "Session has no output";
	case LTTNG_ERR_ROTATION_NOT_AVAILABLE_RELAY:
		return "Rotation feature not available on the relay";
	case LTTNG_ERR_AGENT_TRACING_DISABLED:
		return "Session daemon agent tracing is disabled";
	case LTTNG_ERR_PROBE_LOCATION_INVAL:
		return "Invalid userspace probe location";
	case LTTNG_ERR_ELF_PARSING:
		return "ELF parsing error";
	case LTTNG_ERR_SDT_PROBE_SEMAPHORE:
		return "SDT probe guarded by a semaphore";
	case LTTNG_ERR_ROTATION_FAIL_CONSUMER:
		return "Rotation failure on consumer";
	case LTTNG_ERR_ROTATE_RENAME_FAIL_CONSUMER:
		return "Rotation rename failure on consumer";
	case LTTNG_ERR_ROTATION_PENDING_LOCAL_FAIL_CONSUMER:
		return "Rotation pending check (local) failure on consumer";
	case LTTNG_ERR_ROTATION_PENDING_RELAY_FAIL_CONSUMER:
		return "Rotation pending check (relay) failure on consumer";
	case LTTNG_ERR_MKDIR_FAIL_CONSUMER:
		return "Directory creation failure on consumer";
	case LTTNG_ERR_CHAN_NOT_FOUND:
		return "Channel not found";
	case LTTNG_ERR_SNAPSHOT_UNSUPPORTED:
		return "Session configuration does not allow the use of snapshots";
	case LTTNG_ERR_SESSION_NOT_EXIST:
		return "Recording session does not exist";
	case LTTNG_ERR_CREATE_TRACE_CHUNK_FAIL_CONSUMER:
		return "Trace chunk creation failed on consumer";
	case LTTNG_ERR_CLOSE_TRACE_CHUNK_FAIL_CONSUMER:
		return "Trace chunk close failed on consumer";
	case LTTNG_ERR_TRACE_CHUNK_EXISTS_FAIL_CONSUMER:
		return "Failed to query consumer for trace chunk existence";
	case LTTNG_ERR_INVALID_PROTOCOL:
		return "Protocol error occurred";
	case LTTNG_ERR_FILE_CREATION_ERROR:
		return "Failed to create file";
	case LTTNG_ERR_TIMER_STOP_ERROR:
		return "Failed to stop a timer";
	case LTTNG_ERR_ROTATION_NOT_AVAILABLE_KERNEL:
		return "Rotation feature not supported by the kernel tracer";
	case LTTNG_ERR_CLEAR_RELAY_DISALLOWED:
		return "Relayd daemon peer does not allow sessions to be cleared";
	case LTTNG_ERR_CLEAR_NOT_AVAILABLE_RELAY:
		return "Clearing a session is not supported by the relay daemon";
	case LTTNG_ERR_CLEAR_FAIL_CONSUMER:
		return "Consumer failed to clear the session";
	case LTTNG_ERR_ROTATION_AFTER_STOP_CLEAR:
		return "Session was already cleared since it became inactive";
	case LTTNG_ERR_USER_NOT_FOUND:
		return "User not found";
	case LTTNG_ERR_GROUP_NOT_FOUND:
		return "Group not found";
	case LTTNG_ERR_UNSUPPORTED_DOMAIN:
		return "Unsupported domain used";
	case LTTNG_ERR_PROCESS_ATTR_TRACKER_INVALID_TRACKING_POLICY:
		return "Operation does not apply to the process attribute tracker's tracking policy";
	case LTTNG_ERR_EVENT_NOTIFIER_GROUP_NOTIFICATION_FD:
		return "Failed to create an event notifier group notification file descriptor";
	case LTTNG_ERR_INVALID_CAPTURE_EXPRESSION:
		return "Invalid capture expression";
	case LTTNG_ERR_EVENT_NOTIFIER_REGISTRATION:
		return "Failed to create event notifier";
	case LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING:
		return "Failed to initialize event notifier error accounting";
	case LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING_FULL:
		return "No index available in event notifier error accounting";
	case LTTNG_ERR_INVALID_ERROR_QUERY_TARGET:
		return "Invalid error query target.";
	case LTTNG_ERR_BUFFER_FLUSH_FAILED:
		return "Failed to flush stream buffer";
	case LTTNG_ERR_NR:
		abort();
	}

	abort();
};

/*
 * Return ptr to string representing a human readable error code from the
 * lttng_error_code enum.
 *
 * These code MUST be negative in other to treat that as an error value.
 */
const char *error_get_str(int32_t code)
{
	code = -code;

	if (code < LTTNG_OK || code >= LTTNG_ERR_NR) {
		code = LTTNG_ERR_UNK;
	}

	return lttng_error_code_str((lttng_error_code) code);
}

void lttng_abort_on_error(void)
{
	if (lttng_opt_abort_on_error < 0) {
		/* Use lttng_secure_getenv() to query its state. */
		const char *value;

		value = lttng_secure_getenv("LTTNG_ABORT_ON_ERROR");
		if (value && !strcmp(value, "1")) {
			lttng_opt_abort_on_error = 1;
		} else {
			lttng_opt_abort_on_error = 0;
		}
	}
	if (lttng_opt_abort_on_error > 0) {
		abort();
	}
}
Commit	Line	Data
a6bc4ca9 SM	1	/*
	2	* Copyright (C) 2012 David Goulet <dgoulet@efficios.com>
	3	*
c922647d	4	* SPDX-License-Identifier: LGPL-2.1-only
a6bc4ca9 SM	5	*
	6	*/
	7
	8	#define _LGPL_SOURCE
	9	#include <inttypes.h>
	10	#include <pthread.h>
	11	#include <stdlib.h>
	12	#include <string.h>
	13
	14	#include <common/common.h>
	15	#include <common/thread.h>
	16	#include <common/compat/errno.h>
	17	#include <common/compat/getenv.h>
	18	#include <lttng/lttng-error.h>
	19
	20	#include "error.h"
	21
	22	/*
	23	* lttng_opt_abort_on_error: unset: -1, disabled: 0, enabled: 1.
	24	* Controlled by the LTTNG_ABORT_ON_ERROR environment variable.
	25	*/
	26	static int lttng_opt_abort_on_error = -1;
	27
	28	/* TLS variable that contains the time of one single log entry. */
	29	DEFINE_URCU_TLS(struct log_time, error_log_time);
	30	DEFINE_URCU_TLS(const char *, logger_thread_name);
	31
	32	const char *log_add_time(void)
	33	{
	34	int ret;
	35	struct tm tm, *res;
	36	struct timespec tp;
	37	time_t now;
	38	const int errsv = errno;
	39
	40	ret = lttng_clock_gettime(CLOCK_REALTIME, &tp);
	41	if (ret < 0) {
	42	goto error;
	43	}
	44	now = (time_t) tp.tv_sec;
	45
	46	res = localtime_r(&now, &tm);
	47	if (!res) {
	48	goto error;
	49	}
	50
	51	/* Format time in the TLS variable. */
	52	ret = snprintf(URCU_TLS(error_log_time).str, sizeof(URCU_TLS(error_log_time).str),
	53	"%02d:%02d:%02d.%09ld",
	54	tm.tm_hour, tm.tm_min, tm.tm_sec, tp.tv_nsec);
	55	if (ret < 0) {
	56	goto error;
	57	}
	58
	59	errno = errsv;
	60	return URCU_TLS(error_log_time).str;
	61
	62	error:
	63	/* Return an empty string on error so logging is not affected. */
	64	errno = errsv;
	65	return "";
	66	}
	67
	68	void logger_set_thread_name(const char *name, bool set_pthread_name)
69	{
70	int ret;
71
72	LTTNG_ASSERT(name);
73	URCU_TLS(logger_thread_name) = name;
74
75	if (set_pthread_name) {
76	ret = lttng_thread_setname(name);
77	if (ret && ret != -ENOSYS) {
78	/* Don't fail as this is not essential. */
79	DBG("Failed to set pthread name attribute");
80	}
81	}
82	}
83
84	/*
85	* Human readable error message.
86	*/
87	static
88	const char *lttng_error_code_str(lttng_error_code code)
89	{
90	switch (code) {
91	case LTTNG_OK:
92	return "Success";
93	case LTTNG_ERR_UNK:
94	return "Unknown error";
95	case LTTNG_ERR_UND:
96	return "Undefined command";
97	case LTTNG_ERR_UNKNOWN_DOMAIN:
98	return "Unknown tracing domain";
99	case LTTNG_ERR_NO_SESSION:
100	return "No session found";
101	case LTTNG_ERR_CREATE_DIR_FAIL:
102	return "Create directory failed";
103	case LTTNG_ERR_SESSION_FAIL:
104	return "Create session failed";
105	case LTTNG_ERR_SESS_NOT_FOUND:
106	return "Session name not found";
107	case LTTNG_ERR_FATAL:
108	return "Fatal error of the session daemon";
109	case LTTNG_ERR_SELECT_SESS:
110	return "A session MUST be selected";
111	case LTTNG_ERR_EXIST_SESS:
112	return "Session name already exists";
113	case LTTNG_ERR_NO_EVENT:
114	return "Event not found";
115	case LTTNG_ERR_CONNECT_FAIL:
116	return "Unable to connect to Unix socket";
117	case LTTNG_ERR_EPERM:
118	return "Permission denied";
119	case LTTNG_ERR_KERN_NA:
120	return "Kernel tracer not available";
121	case LTTNG_ERR_KERN_VERSION:
122	return "Kernel tracer version is not compatible";
123	case LTTNG_ERR_KERN_EVENT_EXIST:
124	return "Kernel event already exists";
125	case LTTNG_ERR_KERN_SESS_FAIL:
126	return "Kernel create session failed";
127	case LTTNG_ERR_KERN_CHAN_EXIST:
128	return "Kernel channel already exists";
129	case LTTNG_ERR_KERN_CHAN_FAIL:
130	return "Kernel create channel failed";
131	case LTTNG_ERR_KERN_CHAN_NOT_FOUND:
132	return "Kernel channel not found";
133	case LTTNG_ERR_KERN_CHAN_DISABLE_FAIL:
134	return "Disable kernel channel failed";
135	case LTTNG_ERR_KERN_CHAN_ENABLE_FAIL:
136	return "Enable kernel channel failed";
137	case LTTNG_ERR_KERN_CONTEXT_FAIL:
138	return "Add kernel context failed";
139	case LTTNG_ERR_KERN_ENABLE_FAIL:
140	return "Enable kernel event failed";
141	case LTTNG_ERR_KERN_DISABLE_FAIL:
142	return "Disable kernel event failed";
143	case LTTNG_ERR_KERN_META_FAIL:
144	return "Opening metadata failed";
145	case LTTNG_ERR_KERN_START_FAIL:
146	return "Starting kernel trace failed";
147	case LTTNG_ERR_KERN_STOP_FAIL:
148	return "Stopping kernel trace failed";
149	case LTTNG_ERR_KERN_CONSUMER_FAIL:
150	return "Kernel consumer start failed";
151	case LTTNG_ERR_KERN_STREAM_FAIL:
152	return "Kernel create stream failed";
153	case LTTNG_ERR_KERN_LIST_FAIL:
154	return "Listing kernel events failed";
155	case LTTNG_ERR_UST_CALIBRATE_FAIL:
156	return "UST calibration failed";
157	case LTTNG_ERR_UST_SESS_FAIL:
158	return "UST create session failed";
159	case LTTNG_ERR_UST_CHAN_FAIL:
160	return "UST create channel failed";
161	case LTTNG_ERR_UST_CHAN_EXIST:
162	return "UST channel already exist";
163	case LTTNG_ERR_UST_CHAN_NOT_FOUND:
164	return "UST channel not found";
165	case LTTNG_ERR_UST_CHAN_DISABLE_FAIL:
166	return "Disable UST channel failed";
167	case LTTNG_ERR_UST_CHAN_ENABLE_FAIL:
168	return "Enable UST channel failed";
169	case LTTNG_ERR_UST_ENABLE_FAIL:
170	return "Enable UST event failed";
171	case LTTNG_ERR_UST_DISABLE_FAIL:
172	return "Disable UST event failed";
173	case LTTNG_ERR_UST_META_FAIL:
174	return "Opening metadata failed";
175	case LTTNG_ERR_UST_START_FAIL:
176	return "Starting UST trace failed";
177	case LTTNG_ERR_UST_STOP_FAIL:
178	return "Stopping UST trace failed";
179	case LTTNG_ERR_UST_CONSUMER64_FAIL:
180	return "64-bit UST consumer start failed";
181	case LTTNG_ERR_UST_CONSUMER32_FAIL:
182	return "32-bit UST consumer start failed";
183	case LTTNG_ERR_UST_STREAM_FAIL:
184	return "UST create stream failed";
185	case LTTNG_ERR_UST_LIST_FAIL:
186	return "Listing UST events failed";
187	case LTTNG_ERR_UST_EVENT_EXIST:
188	return "UST event already exist";
189	case LTTNG_ERR_UST_EVENT_NOT_FOUND:
190	return "UST event not found";
191	case LTTNG_ERR_UST_CONTEXT_EXIST:
192	return "UST context already exist";
193	case LTTNG_ERR_UST_CONTEXT_INVAL:
194	return "UST invalid context";
195	case LTTNG_ERR_NEED_ROOT_SESSIOND:
196	return "Tracing the kernel requires a root lttng-sessiond daemon, as well as \"tracing\" group membership or root user ID for the lttng client";
197	case LTTNG_ERR_NO_UST:
198	return "LTTng-UST tracer is not supported. Please rebuild lttng-tools with lttng-ust support enabled";
199	case LTTNG_ERR_TRACE_ALREADY_STARTED:
200	return "Tracing has already been started once";
201	case LTTNG_ERR_TRACE_ALREADY_STOPPED:
202	return "Tracing has already been stopped";
203	case LTTNG_ERR_KERN_EVENT_ENOSYS:
204	return "Kernel event type not supported";
205	case LTTNG_ERR_NEED_CHANNEL_NAME:
206	return "Non-default channel exists within session: channel name needs to be specified with '-c name'";
207	case LTTNG_ERR_INVALID:
208	return "Invalid parameter";
209	case LTTNG_ERR_NO_USTCONSUMERD:
210	return "No UST consumer detected";
211	case LTTNG_ERR_NO_KERNCONSUMERD:
212	return "No kernel consumer detected";
213	case LTTNG_ERR_EVENT_EXIST_LOGLEVEL:
214	return "Event already enabled with different loglevel";
215	case LTTNG_ERR_URL_DATA_MISS:
216	return "Missing data path URL";
217	case LTTNG_ERR_URL_CTRL_MISS:
218	return "Missing control path URL";
219	case LTTNG_ERR_ENABLE_CONSUMER_FAIL:
220	return "Enabling consumer failed";
221	case LTTNG_ERR_RELAYD_CONNECT_FAIL:
222	return "Unable to connect to lttng-relayd";
223	case LTTNG_ERR_RELAYD_VERSION_FAIL:
224	return "Relay daemon not compatible";
225	case LTTNG_ERR_FILTER_INVAL:
226	return "Invalid filter bytecode";
227	case LTTNG_ERR_FILTER_NOMEM:
228	return "Not enough memory for filter bytecode";
229	case LTTNG_ERR_FILTER_EXIST:
230	return "Filter already exist";
231	case LTTNG_ERR_NO_CONSUMER:
232	return "Consumer not found for recording session";
233	case LTTNG_ERR_EXCLUSION_INVAL:
234	return "Invalid event exclusion data";
235	case LTTNG_ERR_EXCLUSION_NOMEM:
236	return "Lack of memory while processing event exclusions";
237	case LTTNG_ERR_NO_SESSIOND:
238	return "No session daemon is available";
239	case LTTNG_ERR_SESSION_STARTED:
240	return "Session is running";
241	case LTTNG_ERR_NOT_SUPPORTED:
242	return "Operation not supported";
243	case LTTNG_ERR_UST_EVENT_ENABLED:
244	return "UST event already enabled";
245	case LTTNG_ERR_SET_URL:
246	return "Error setting URL";
247	case LTTNG_ERR_URL_EXIST:
248	return "URL already exists";
249	case LTTNG_ERR_BUFFER_NOT_SUPPORTED:
250	return "Buffer type not supported";
251	case LTTNG_ERR_BUFFER_TYPE_MISMATCH:
252	return "Buffer type mismatch for session";
253	case LTTNG_ERR_NOMEM:
254	return "Not enough memory";
255	case LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST:
256	return "Snapshot output already exists";
257	case LTTNG_ERR_START_SESSION_ONCE:
258	return "Session needs to be started once";
259	case LTTNG_ERR_SNAPSHOT_FAIL:
260	return "Snapshot record failed";
261	case LTTNG_ERR_NO_STREAM:
262	return "Index without stream on relay";
263	case LTTNG_ERR_CHAN_EXIST:
264	return "Channel already exists";
265	case LTTNG_ERR_SNAPSHOT_NODATA:
266	return "No data available in snapshot";
267	case LTTNG_ERR_NO_CHANNEL:
268	return "No channel found in the session";
269	case LTTNG_ERR_SESSION_INVALID_CHAR:
270	return "Invalid character found in session name";
271	case LTTNG_ERR_SAVE_FILE_EXIST:
272	return "Session file already exists";
273	case LTTNG_ERR_SAVE_IO_FAIL:
274	return "IO error while writing session configuration";
275	case LTTNG_ERR_LOAD_INVALID_CONFIG:
276	return "Invalid session configuration";
277	case LTTNG_ERR_LOAD_IO_FAIL:
278	return "IO error while reading a session configuration";
279	case LTTNG_ERR_LOAD_SESSION_NOENT:
280	return "Session file not found";
281	case LTTNG_ERR_MAX_SIZE_INVALID:
282	return "Snapshot max size is invalid";
283	case LTTNG_ERR_MI_OUTPUT_TYPE:
284	return "Invalid MI output format";
285	case LTTNG_ERR_MI_IO_FAIL:
286	return "IO error while writing MI output";
287	case LTTNG_ERR_MI_NOT_IMPLEMENTED:
288	return "Mi feature not implemented";
289	case LTTNG_ERR_INVALID_EVENT_NAME:
290	return "Invalid event name";
291	case LTTNG_ERR_INVALID_CHANNEL_NAME:
292	return "Invalid channel name";
293	case LTTNG_ERR_PROCESS_ATTR_EXISTS:
294	return "Process attribute is already tracked";
295	case LTTNG_ERR_PROCESS_ATTR_MISSING:
296	return "Process attribute was not tracked";
297	case LTTNG_ERR_INVALID_CHANNEL_DOMAIN:
298	return "Invalid channel domain";
299	case LTTNG_ERR_OVERFLOW:
300	return "Overflow occurred";
301	case LTTNG_ERR_SESSION_NOT_STARTED:
302	return "Session not started";
303	case LTTNG_ERR_LIVE_SESSION:
304	return "Live sessions are not supported";
305	case LTTNG_ERR_PER_PID_SESSION:
306	return "Per-PID recording sessions are not supported";
307	case LTTNG_ERR_KERN_CONTEXT_UNAVAILABLE:
308	return "Context unavailable on this kernel";
309	case LTTNG_ERR_REGEN_STATEDUMP_FAIL:
310	return "Failed to regenerate the state dump";
311	case LTTNG_ERR_REGEN_STATEDUMP_NOMEM:
312	return "Failed to regenerate the state dump, not enough memory";
313	case LTTNG_ERR_NOT_SNAPSHOT_SESSION:
314	return "Snapshot command can't be applied to a non-snapshot session";
315	case LTTNG_ERR_INVALID_TRIGGER:
316	return "Invalid trigger";
317	case LTTNG_ERR_TRIGGER_EXISTS:
318	return "Trigger already registered";
319	case LTTNG_ERR_TRIGGER_NOT_FOUND:
320	return "Trigger not found";
321	case LTTNG_ERR_COMMAND_CANCELLED:
322	return "Command cancelled";
323	case LTTNG_ERR_ROTATION_PENDING:
324	return "Rotation already pending for this session";
325	case LTTNG_ERR_ROTATION_NOT_AVAILABLE:
326	return "Rotation feature not available for this session's creation mode";
327	case LTTNG_ERR_ROTATION_SCHEDULE_SET:
328	return "A session rotation schedule of this type is already set on the session";
329	case LTTNG_ERR_ROTATION_SCHEDULE_NOT_SET:
330	return "No session rotation schedule of this type is set on the session";
331	case LTTNG_ERR_ROTATION_MULTIPLE_AFTER_STOP:
332	return "Session was already rotated once since it became inactive";
333	case LTTNG_ERR_ROTATION_WRONG_VERSION:
334	return "Session rotation is not supported by this kernel tracer version";
335	case LTTNG_ERR_NO_SESSION_OUTPUT:
336	return "Session has no output";
337	case LTTNG_ERR_ROTATION_NOT_AVAILABLE_RELAY:
338	return "Rotation feature not available on the relay";
339	case LTTNG_ERR_AGENT_TRACING_DISABLED:
340	return "Session daemon agent tracing is disabled";
341	case LTTNG_ERR_PROBE_LOCATION_INVAL:
342	return "Invalid userspace probe location";
343	case LTTNG_ERR_ELF_PARSING:
344	return "ELF parsing error";
345	case LTTNG_ERR_SDT_PROBE_SEMAPHORE:
346	return "SDT probe guarded by a semaphore";
347	case LTTNG_ERR_ROTATION_FAIL_CONSUMER:
348	return "Rotation failure on consumer";
349	case LTTNG_ERR_ROTATE_RENAME_FAIL_CONSUMER:
350	return "Rotation rename failure on consumer";
351	case LTTNG_ERR_ROTATION_PENDING_LOCAL_FAIL_CONSUMER:
352	return "Rotation pending check (local) failure on consumer";
353	case LTTNG_ERR_ROTATION_PENDING_RELAY_FAIL_CONSUMER:
354	return "Rotation pending check (relay) failure on consumer";
355	case LTTNG_ERR_MKDIR_FAIL_CONSUMER:
356	return "Directory creation failure on consumer";
357	case LTTNG_ERR_CHAN_NOT_FOUND:
358	return "Channel not found";
359	case LTTNG_ERR_SNAPSHOT_UNSUPPORTED:
360	return "Session configuration does not allow the use of snapshots";
361	case LTTNG_ERR_SESSION_NOT_EXIST:
362	return "Recording session does not exist";
363	case LTTNG_ERR_CREATE_TRACE_CHUNK_FAIL_CONSUMER:
364	return "Trace chunk creation failed on consumer";
365	case LTTNG_ERR_CLOSE_TRACE_CHUNK_FAIL_CONSUMER:
366	return "Trace chunk close failed on consumer";
367	case LTTNG_ERR_TRACE_CHUNK_EXISTS_FAIL_CONSUMER:
368	return "Failed to query consumer for trace chunk existence";
369	case LTTNG_ERR_INVALID_PROTOCOL:
370	return "Protocol error occurred";
371	case LTTNG_ERR_FILE_CREATION_ERROR:
372	return "Failed to create file";
373	case LTTNG_ERR_TIMER_STOP_ERROR:
374	return "Failed to stop a timer";
375	case LTTNG_ERR_ROTATION_NOT_AVAILABLE_KERNEL:
376	return "Rotation feature not supported by the kernel tracer";
377	case LTTNG_ERR_CLEAR_RELAY_DISALLOWED:
378	return "Relayd daemon peer does not allow sessions to be cleared";
379	case LTTNG_ERR_CLEAR_NOT_AVAILABLE_RELAY:
380	return "Clearing a session is not supported by the relay daemon";
381	case LTTNG_ERR_CLEAR_FAIL_CONSUMER:
382	return "Consumer failed to clear the session";
383	case LTTNG_ERR_ROTATION_AFTER_STOP_CLEAR:
384	return "Session was already cleared since it became inactive";
385	case LTTNG_ERR_USER_NOT_FOUND:
386	return "User not found";
387	case LTTNG_ERR_GROUP_NOT_FOUND:
388	return "Group not found";
389	case LTTNG_ERR_UNSUPPORTED_DOMAIN:
390	return "Unsupported domain used";
391	case LTTNG_ERR_PROCESS_ATTR_TRACKER_INVALID_TRACKING_POLICY:
392	return "Operation does not apply to the process attribute tracker's tracking policy";
393	case LTTNG_ERR_EVENT_NOTIFIER_GROUP_NOTIFICATION_FD:
394	return "Failed to create an event notifier group notification file descriptor";
395	case LTTNG_ERR_INVALID_CAPTURE_EXPRESSION:
396	return "Invalid capture expression";
397	case LTTNG_ERR_EVENT_NOTIFIER_REGISTRATION:
398	return "Failed to create event notifier";
399	case LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING:
400	return "Failed to initialize event notifier error accounting";
401	case LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING_FULL:
402	return "No index available in event notifier error accounting";
403	case LTTNG_ERR_INVALID_ERROR_QUERY_TARGET:
404	return "Invalid error query target.";
405	case LTTNG_ERR_BUFFER_FLUSH_FAILED:
406	return "Failed to flush stream buffer";
407	case LTTNG_ERR_NR:
408	abort();
409	}
410
411	abort();
412	};
413
414	/*
415	* Return ptr to string representing a human readable error code from the
416	* lttng_error_code enum.
417	*
418	* These code MUST be negative in other to treat that as an error value.
419	*/
420	const char *error_get_str(int32_t code)
421	{
422	code = -code;
423
424	if (code < LTTNG_OK \|\| code >= LTTNG_ERR_NR) {
425	code = LTTNG_ERR_UNK;
426	}
427
428	return lttng_error_code_str((lttng_error_code) code);
429	}
430
431	void lttng_abort_on_error(void)
432	{
433	if (lttng_opt_abort_on_error < 0) {
434	/* Use lttng_secure_getenv() to query its state. */
435	const char *value;
436
437	value = lttng_secure_getenv("LTTNG_ABORT_ON_ERROR");
438	if (value && !strcmp(value, "1")) {
439	lttng_opt_abort_on_error = 1;
440	} else {
441	lttng_opt_abort_on_error = 0;
442	}
443	}
444	if (lttng_opt_abort_on_error > 0) {
445	abort();
446	}
447	}