Metadata: add env fields to ease lttng path hierarchy creation for viewer
[lttng-tools.git] / src / common / error.c
CommitLineData
f73fabfd
DG
1/*
2 * Copyright (C) 2012 - David Goulet <dgoulet@efficios.com>
3 *
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License, version 2 only, as
6 * published by the Free Software Foundation.
7 *
8 * This program is distributed in the hope that it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
11 * more details.
12 *
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 51
15 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
16 */
17
6c1c0768 18#define _LGPL_SOURCE
f73fabfd 19#include <assert.h>
a0b439da 20#include <inttypes.h>
9bbd8e06
MD
21#include <stdlib.h>
22#include <string.h>
b1093e5f 23#include <errno.h>
f73fabfd
DG
24
25#include <lttng/lttng-error.h>
90e535ef 26#include <common/common.h>
9bbd8e06 27#include <common/compat/getenv.h>
f73fabfd
DG
28
29#include "error.h"
30
31#define ERROR_INDEX(code) (code - LTTNG_OK)
32
9bbd8e06
MD
33/*
34 * lttng_opt_abort_on_error: unset: -1, disabled: 0, enabled: 1.
35 * Controlled by the LTTNG_ABORT_ON_ERROR environment variable.
36 */
37static int lttng_opt_abort_on_error = -1;
38
a0b439da
DG
39/* TLS variable that contains the time of one single log entry. */
40DEFINE_URCU_TLS(struct log_time, error_log_time);
41
b2035012 42LTTNG_HIDDEN
a0b439da
DG
43const char *log_add_time(void)
44{
45 int ret;
46 struct tm tm, *res;
47 struct timespec tp;
48 time_t now;
b1093e5f 49 const int errsv = errno;
a0b439da 50
389fbf04 51 ret = lttng_clock_gettime(CLOCK_REALTIME, &tp);
a0b439da
DG
52 if (ret < 0) {
53 goto error;
54 }
55 now = (time_t) tp.tv_sec;
56
57 res = localtime_r(&now, &tm);
58 if (!res) {
59 goto error;
60 }
61
62 /* Format time in the TLS variable. */
327115d8 63 ret = snprintf(URCU_TLS(error_log_time).str, sizeof(URCU_TLS(error_log_time).str),
870bdaf9 64 "%02d:%02d:%02d.%09ld",
a0b439da
DG
65 tm.tm_hour, tm.tm_min, tm.tm_sec, tp.tv_nsec);
66 if (ret < 0) {
67 goto error;
68 }
69
b1093e5f 70 errno = errsv;
f79e29fe 71 return URCU_TLS(error_log_time).str;
a0b439da
DG
72
73error:
74 /* Return an empty string on error so logging is not affected. */
b1093e5f 75 errno = errsv;
a0b439da
DG
76 return "";
77}
78
f73fabfd
DG
79/*
80 * Human readable error message.
81 */
82static const char *error_string_array[] = {
83 /* LTTNG_OK code MUST be at the top for the ERROR_INDEX macro to work */
84 [ ERROR_INDEX(LTTNG_OK) ] = "Success",
85 [ ERROR_INDEX(LTTNG_ERR_UNK) ] = "Unknown error",
86 [ ERROR_INDEX(LTTNG_ERR_UND) ] = "Undefined command",
87 [ ERROR_INDEX(LTTNG_ERR_UNKNOWN_DOMAIN) ] = "Unknown tracing domain",
88 [ ERROR_INDEX(LTTNG_ERR_NO_SESSION) ] = "No session found",
89 [ ERROR_INDEX(LTTNG_ERR_CREATE_DIR_FAIL) ] = "Create directory failed",
90 [ ERROR_INDEX(LTTNG_ERR_SESSION_FAIL) ] = "Create session failed",
91 [ ERROR_INDEX(LTTNG_ERR_SESS_NOT_FOUND) ] = "Session name not found",
92 [ ERROR_INDEX(LTTNG_ERR_FATAL) ] = "Fatal error of the session daemon",
93 [ ERROR_INDEX(LTTNG_ERR_SELECT_SESS) ] = "A session MUST be selected",
552c8777 94 [ ERROR_INDEX(LTTNG_ERR_EXIST_SESS) ] = "Session name already exists",
f73fabfd
DG
95 [ ERROR_INDEX(LTTNG_ERR_NO_EVENT) ] = "Event not found",
96 [ ERROR_INDEX(LTTNG_ERR_CONNECT_FAIL) ] = "Unable to connect to Unix socket",
97 [ ERROR_INDEX(LTTNG_ERR_EPERM) ] = "Permission denied",
98 [ ERROR_INDEX(LTTNG_ERR_KERN_NA) ] = "Kernel tracer not available",
99 [ ERROR_INDEX(LTTNG_ERR_KERN_VERSION) ] = "Kernel tracer version is not compatible",
100 [ ERROR_INDEX(LTTNG_ERR_KERN_EVENT_EXIST) ] = "Kernel event already exists",
101 [ ERROR_INDEX(LTTNG_ERR_KERN_SESS_FAIL) ] = "Kernel create session failed",
102 [ ERROR_INDEX(LTTNG_ERR_KERN_CHAN_EXIST) ] = "Kernel channel already exists",
103 [ ERROR_INDEX(LTTNG_ERR_KERN_CHAN_FAIL) ] = "Kernel create channel failed",
104 [ ERROR_INDEX(LTTNG_ERR_KERN_CHAN_NOT_FOUND) ] = "Kernel channel not found",
105 [ ERROR_INDEX(LTTNG_ERR_KERN_CHAN_DISABLE_FAIL) ] = "Disable kernel channel failed",
106 [ ERROR_INDEX(LTTNG_ERR_KERN_CHAN_ENABLE_FAIL) ] = "Enable kernel channel failed",
107 [ ERROR_INDEX(LTTNG_ERR_KERN_CONTEXT_FAIL) ] = "Add kernel context failed",
108 [ ERROR_INDEX(LTTNG_ERR_KERN_ENABLE_FAIL) ] = "Enable kernel event failed",
109 [ ERROR_INDEX(LTTNG_ERR_KERN_DISABLE_FAIL) ] = "Disable kernel event failed",
110 [ ERROR_INDEX(LTTNG_ERR_KERN_META_FAIL) ] = "Opening metadata failed",
111 [ ERROR_INDEX(LTTNG_ERR_KERN_START_FAIL) ] = "Starting kernel trace failed",
552c8777 112 [ ERROR_INDEX(LTTNG_ERR_KERN_STOP_FAIL) ] = "Stopping kernel trace failed",
f73fabfd
DG
113 [ ERROR_INDEX(LTTNG_ERR_KERN_CONSUMER_FAIL) ] = "Kernel consumer start failed",
114 [ ERROR_INDEX(LTTNG_ERR_KERN_STREAM_FAIL) ] = "Kernel create stream failed",
115 [ ERROR_INDEX(LTTNG_ERR_KERN_LIST_FAIL) ] = "Listing kernel events failed",
116 [ ERROR_INDEX(LTTNG_ERR_UST_CALIBRATE_FAIL) ] = "UST calibration failed",
117 [ ERROR_INDEX(LTTNG_ERR_UST_SESS_FAIL) ] = "UST create session failed",
118 [ ERROR_INDEX(LTTNG_ERR_UST_CHAN_FAIL) ] = "UST create channel failed",
119 [ ERROR_INDEX(LTTNG_ERR_UST_CHAN_EXIST) ] = "UST channel already exist",
120 [ ERROR_INDEX(LTTNG_ERR_UST_CHAN_NOT_FOUND) ] = "UST channel not found",
121 [ ERROR_INDEX(LTTNG_ERR_UST_CHAN_DISABLE_FAIL) ] = "Disable UST channel failed",
122 [ ERROR_INDEX(LTTNG_ERR_UST_CHAN_ENABLE_FAIL) ] = "Enable UST channel failed",
123 [ ERROR_INDEX(LTTNG_ERR_UST_ENABLE_FAIL) ] = "Enable UST event failed",
124 [ ERROR_INDEX(LTTNG_ERR_UST_DISABLE_FAIL) ] = "Disable UST event failed",
125 [ ERROR_INDEX(LTTNG_ERR_UST_META_FAIL) ] = "Opening metadata failed",
126 [ ERROR_INDEX(LTTNG_ERR_UST_START_FAIL) ] = "Starting UST trace failed",
552c8777 127 [ ERROR_INDEX(LTTNG_ERR_UST_STOP_FAIL) ] = "Stopping UST trace failed",
f73fabfd
DG
128 [ ERROR_INDEX(LTTNG_ERR_UST_CONSUMER64_FAIL) ] = "64-bit UST consumer start failed",
129 [ ERROR_INDEX(LTTNG_ERR_UST_CONSUMER32_FAIL) ] = "32-bit UST consumer start failed",
130 [ ERROR_INDEX(LTTNG_ERR_UST_STREAM_FAIL) ] = "UST create stream failed",
131 [ ERROR_INDEX(LTTNG_ERR_UST_LIST_FAIL) ] = "Listing UST events failed",
132 [ ERROR_INDEX(LTTNG_ERR_UST_EVENT_EXIST) ] = "UST event already exist",
133 [ ERROR_INDEX(LTTNG_ERR_UST_EVENT_NOT_FOUND)] = "UST event not found",
134 [ ERROR_INDEX(LTTNG_ERR_UST_CONTEXT_EXIST)] = "UST context already exist",
135 [ ERROR_INDEX(LTTNG_ERR_UST_CONTEXT_INVAL)] = "UST invalid context",
1052de37 136 [ ERROR_INDEX(LTTNG_ERR_NEED_ROOT_SESSIOND) ] = "Tracing the kernel requires a root lttng-sessiond daemon, as well as \"tracing\" group membership or root user ID for the lttng client.",
b51ec5b4 137 [ ERROR_INDEX(LTTNG_ERR_NO_UST) ] = "LTTng-UST tracer is not supported. Please rebuild lttng-tools with lttng-ust support enabled.",
45d5d421
CB
138 [ ERROR_INDEX(LTTNG_ERR_TRACE_ALREADY_STARTED) ] = "Tracing has already been started once",
139 [ ERROR_INDEX(LTTNG_ERR_TRACE_ALREADY_STOPPED) ] = "Tracing has already been stopped",
f73fabfd 140 [ ERROR_INDEX(LTTNG_ERR_KERN_EVENT_ENOSYS) ] = "Kernel event type not supported",
85076754 141 [ ERROR_INDEX(LTTNG_ERR_NEED_CHANNEL_NAME) ] = "Non-default channel exists within session: channel name needs to be specified with '-c name'",
f73fabfd
DG
142 [ ERROR_INDEX(LTTNG_ERR_INVALID) ] = "Invalid parameter",
143 [ ERROR_INDEX(LTTNG_ERR_NO_USTCONSUMERD) ] = "No UST consumer detected",
144 [ ERROR_INDEX(LTTNG_ERR_NO_KERNCONSUMERD) ] = "No kernel consumer detected",
145 [ ERROR_INDEX(LTTNG_ERR_EVENT_EXIST_LOGLEVEL) ] = "Event already enabled with different loglevel",
146 [ ERROR_INDEX(LTTNG_ERR_URL_DATA_MISS) ] = "Missing data path URL",
552c8777 147 [ ERROR_INDEX(LTTNG_ERR_URL_CTRL_MISS) ] = "Missing control path URL",
f73fabfd
DG
148 [ ERROR_INDEX(LTTNG_ERR_ENABLE_CONSUMER_FAIL) ] = "Enabling consumer failed",
149 [ ERROR_INDEX(LTTNG_ERR_RELAYD_CONNECT_FAIL) ] = "Unable to connect to lttng-relayd",
150 [ ERROR_INDEX(LTTNG_ERR_RELAYD_VERSION_FAIL) ] = "Relay daemon not compatible",
151 [ ERROR_INDEX(LTTNG_ERR_FILTER_INVAL) ] = "Invalid filter bytecode",
152 [ ERROR_INDEX(LTTNG_ERR_FILTER_NOMEM) ] = "Not enough memory for filter bytecode",
153 [ ERROR_INDEX(LTTNG_ERR_FILTER_EXIST) ] = "Filter already exist",
154 [ ERROR_INDEX(LTTNG_ERR_NO_CONSUMER) ] = "Consumer not found for tracing session",
2f70b271 155 [ ERROR_INDEX(LTTNG_ERR_NO_SESSIOND) ] = "No session daemon is available",
806e2684 156 [ ERROR_INDEX(LTTNG_ERR_SESSION_STARTED) ] = "Session is running",
a79d84dd 157 [ ERROR_INDEX(LTTNG_ERR_NOT_SUPPORTED) ] = "Operation not supported",
5bcdda4f 158 [ ERROR_INDEX(LTTNG_ERR_UST_EVENT_ENABLED) ] = "UST event already enabled",
785d2d0d
DG
159 [ ERROR_INDEX(LTTNG_ERR_SET_URL) ] = "Error setting URL",
160 [ ERROR_INDEX(LTTNG_ERR_URL_EXIST) ] = "URL already exists",
7972aab2
DG
161 [ ERROR_INDEX(LTTNG_ERR_BUFFER_NOT_SUPPORTED)] = "Buffer type not supported",
162 [ ERROR_INDEX(LTTNG_ERR_BUFFER_TYPE_MISMATCH)] = "Buffer type mismatch for session",
a74934ba 163 [ ERROR_INDEX(LTTNG_ERR_NOMEM)] = "Not enough memory",
6dc3064a
DG
164 [ ERROR_INDEX(LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST) ] = "Snapshot output already exists",
165 [ ERROR_INDEX(LTTNG_ERR_START_SESSION_ONCE) ] = "Session needs to be started once",
5c786ded 166 [ ERROR_INDEX(LTTNG_ERR_SNAPSHOT_FAIL) ] = "Snapshot record failed",
b9dfb167 167 [ ERROR_INDEX(LTTNG_ERR_CHAN_EXIST) ] = "Channel already exists",
7badf927 168 [ ERROR_INDEX(LTTNG_ERR_SNAPSHOT_NODATA) ] = "No data available in snapshot",
cde3e505 169 [ ERROR_INDEX(LTTNG_ERR_NO_CHANNEL) ] = "No channel found in the session",
1c1c3634 170 [ ERROR_INDEX(LTTNG_ERR_SESSION_INVALID_CHAR) ] = "Invalid character found in session name",
f9b57ab2 171 [ ERROR_INDEX(LTTNG_ERR_SAVE_FILE_EXIST) ] = "Session file already exists",
b61eecd6 172 [ ERROR_INDEX(LTTNG_ERR_SAVE_IO_FAIL) ] = "IO error while writing session configuration",
a96bc65d
DG
173 [ ERROR_INDEX(LTTNG_ERR_LOAD_INVALID_CONFIG) ] = "Invalid session configuration",
174 [ ERROR_INDEX(LTTNG_ERR_LOAD_IO_FAIL) ] = "IO error while reading a session configuration",
175 [ ERROR_INDEX(LTTNG_ERR_LOAD_SESSION_NOENT) ] = "Session file not found",
68808f4e 176 [ ERROR_INDEX(LTTNG_ERR_MAX_SIZE_INVALID) ] = "Snapshot max size is invalid",
c7e35b03
JR
177 [ ERROR_INDEX(LTTNG_ERR_MI_OUTPUT_TYPE) ] = "Invalid MI output format",
178 [ ERROR_INDEX(LTTNG_ERR_MI_IO_FAIL) ] = "IO error while writing MI output",
179 [ ERROR_INDEX(LTTNG_ERR_MI_NOT_IMPLEMENTED) ] = "Mi feature not implemented",
930a2e99 180 [ ERROR_INDEX(LTTNG_ERR_INVALID_EVENT_NAME) ] = "Invalid event name",
1f345e94 181 [ ERROR_INDEX(LTTNG_ERR_INVALID_CHANNEL_NAME) ] = "Invalid channel name",
b93a4a13
MJ
182 [ ERROR_INDEX(LTTNG_ERR_PID_TRACKED) ] = "PID already tracked",
183 [ ERROR_INDEX(LTTNG_ERR_PID_NOT_TRACKED) ] = "PID not tracked",
141feb8c 184 [ ERROR_INDEX(LTTNG_ERR_INVALID_CHANNEL_DOMAIN) ] = "Invalid channel domain",
83f4233d 185 [ ERROR_INDEX(LTTNG_ERR_OVERFLOW) ] = "Overflow occurred",
93ec662e
JD
186 [ ERROR_INDEX(LTTNG_ERR_SESSION_NOT_STARTED) ] = "Session not started",
187 [ ERROR_INDEX(LTTNG_ERR_LIVE_SESSION) ] = "Live sessions are not supported",
188 [ ERROR_INDEX(LTTNG_ERR_PER_PID_SESSION) ] = "Per-PID tracing sessions are not supported",
1ae5e83e 189 [ ERROR_INDEX(LTTNG_ERR_KERN_CONTEXT_UNAVAILABLE) ] = "Context unavailable on this kernel",
c2561365
JD
190 [ ERROR_INDEX(LTTNG_ERR_REGEN_STATEDUMP_FAIL) ] = "Failed to regenerate the state dump",
191 [ ERROR_INDEX(LTTNG_ERR_REGEN_STATEDUMP_NOMEM) ] = "Failed to regenerate the state dump, not enough memory",
903ef685 192 [ ERROR_INDEX(LTTNG_ERR_NOT_SNAPSHOT_SESSION) ] = "Snapshot command can't be applied to a non-snapshot session",
a58c490f
JG
193 [ ERROR_INDEX(LTTNG_ERR_INVALID_TRIGGER) ] = "Invalid trigger",
194 [ ERROR_INDEX(LTTNG_ERR_TRIGGER_EXISTS) ] = "Trigger already registered",
195 [ ERROR_INDEX(LTTNG_ERR_TRIGGER_NOT_FOUND) ] = "Trigger not found",
196 [ ERROR_INDEX(LTTNG_ERR_COMMAND_CANCELLED) ] = "Command cancelled",
5c408ad8
JD
197 [ ERROR_INDEX(LTTNG_ERR_ROTATION_PENDING) ] = "Rotation already pending for this session",
198 [ ERROR_INDEX(LTTNG_ERR_ROTATION_NOT_AVAILABLE) ] = "Rotation feature not available for this session's creation mode",
66ea93b1
JG
199 [ ERROR_INDEX(LTTNG_ERR_ROTATION_SCHEDULE_SET) ] = "A session rotation schedule of this type is already set on the session",
200 [ ERROR_INDEX(LTTNG_ERR_ROTATION_SCHEDULE_NOT_SET) ] = "No session rotation schedule of this type is set on the session",
5c408ad8 201 [ ERROR_INDEX(LTTNG_ERR_ROTATION_MULTIPLE_AFTER_STOP) ] = "Session was already rotated once since it became inactive",
259c2674 202 [ ERROR_INDEX(LTTNG_ERR_ROTATION_WRONG_VERSION) ] = "Session rotation is not supported by this kernel tracer version",
d68c9a04 203 [ ERROR_INDEX(LTTNG_ERR_NO_SESSION_OUTPUT) ] = "Session has no output",
504521ea 204 [ ERROR_INDEX(LTTNG_ERR_ROTATION_NOT_AVAILABLE_RELAY) ] = "Rotation feature not available on the relay",
f28f9e44 205 [ ERROR_INDEX(LTTNG_ERR_AGENT_TRACING_DISABLED) ] = "Session daemon agent tracing is disabled",
1a1c3874 206 [ ERROR_INDEX(LTTNG_ERR_PROBE_LOCATION_INVAL) ] = "Invalid userspace probe location",
d0927b41 207 [ ERROR_INDEX(LTTNG_ERR_ELF_PARSING) ] = "ELF parsing error",
8bd52288 208 [ ERROR_INDEX(LTTNG_ERR_SDT_PROBE_SEMAPHORE) ] = "SDT probe guarded by a semaphore",
20f37cb4
MD
209 [ ERROR_INDEX(LTTNG_ERR_ROTATION_FAIL_CONSUMER) ] = "Rotation failure on consumer",
210 [ ERROR_INDEX(LTTNG_ERR_ROTATE_RENAME_FAIL_CONSUMER) ] = "Rotation rename failure on consumer",
211 [ ERROR_INDEX(LTTNG_ERR_ROTATION_PENDING_LOCAL_FAIL_CONSUMER) ] = "Rotation pending check (local) failure on consumer",
212 [ ERROR_INDEX(LTTNG_ERR_ROTATION_PENDING_RELAY_FAIL_CONSUMER) ] = "Rotation pending check (relay) failure on consumer",
213 [ ERROR_INDEX(LTTNG_ERR_MKDIR_FAIL_CONSUMER) ] = "mkdir failure on consumer",
214 [ ERROR_INDEX(LTTNG_ERR_CHAN_NOT_FOUND) ] = "Channel not found",
54213acc 215 [ ERROR_INDEX(LTTNG_ERR_SNAPSHOT_UNSUPPORTED) ] = "Session configuration does not allow the use of snapshots",
b178f53e 216 [ ERROR_INDEX(LTTNG_ERR_SESSION_NOT_EXIST) ] = "Tracing session does not exist",
d2956687
JG
217 [ ERROR_INDEX(LTTNG_ERR_CREATE_TRACE_CHUNK_FAIL_CONSUMER) ] = "Trace chunk creation failed on consumer",
218 [ ERROR_INDEX(LTTNG_ERR_CLOSE_TRACE_CHUNK_FAIL_CONSUMER) ] = "Trace chunk close failed on consumer",
219 [ ERROR_INDEX(LTTNG_ERR_TRACE_CHUNK_EXISTS_FAIL_CONSUMER) ] = "Failed to query consumer for trace chunk existence",
3e3665b8 220 [ ERROR_INDEX(LTTNG_ERR_INVALID_PROTOCOL) ] = "Protocol error occurred",
c35f9726 221 [ ERROR_INDEX(LTTNG_ERR_FILE_CREATION_ERROR) ] = "Failed to create file",
f73fabfd
DG
222
223 /* Last element */
224 [ ERROR_INDEX(LTTNG_ERR_NR) ] = "Unknown error code"
225};
226
227/*
228 * Return ptr to string representing a human readable error code from the
229 * lttng_error_code enum.
230 *
231 * These code MUST be negative in other to treat that as an error value.
232 */
90e535ef 233LTTNG_HIDDEN
f73fabfd
DG
234const char *error_get_str(int32_t code)
235{
236 code = -code;
237
238 if (code < LTTNG_OK || code > LTTNG_ERR_NR) {
239 code = LTTNG_ERR_NR;
240 }
241
242 return error_string_array[ERROR_INDEX(code)];
243}
9bbd8e06
MD
244
245LTTNG_HIDDEN
246void lttng_abort_on_error(void)
247{
248 if (lttng_opt_abort_on_error < 0) {
249 /* Use lttng_secure_getenv() to query its state. */
250 const char *value;
251
252 value = lttng_secure_getenv("LTTNG_ABORT_ON_ERROR");
253 if (value && !strcmp(value, "1")) {
254 lttng_opt_abort_on_error = 1;
255 } else {
256 lttng_opt_abort_on_error = 0;
257 }
258 }
259 if (lttng_opt_abort_on_error > 0) {
260 abort();
261 }
262}
This page took 0.083274 seconds and 5 git commands to generate.