LTTng control library C API
Loading...
Searching...
No Matches
lttng-error.h
1/*
2 * lttng-error.h
3 *
4 * Linux Trace Toolkit Control Library Error Header File
5 *
6 * The following values are all the possible errors the lttng command line
7 * client can quit with.
8 *
9 * SPDX-FileCopyrightText: 2012 David Goulet <dgoulet@efficios.com>
10 *
11 * SPDX-License-Identifier: LGPL-2.1-only
12 *
13 */
14
15#ifndef LTTNG_ERROR_H
16#define LTTNG_ERROR_H
17
18#ifdef __cplusplus
19extern "C" {
20#endif
21
22#include <lttng/lttng-export.h>
23
50 /* Internal codes */
52 LTTNG_ERR_SELECT_SESS = 27, /* Must select a session */
53 LTTNG_ERR_NO_STREAM = 52, /* Index without stream on relay. */
54 LTTNG_ERR_UST_CALIBRATE_FAIL = 54, /* UST calibration failed */
55 LTTNG_ERR_UST_CHAN_ENABLE_FAIL = 61, /* UST enable channel failed */
56 LTTNG_ERR_CHAN_EXIST = 62, /* Channel already exists. */
57 LTTNG_ERR_UST_META_FAIL = 65, /* UST open metadata failed */
58 LTTNG_ERR_UST_STREAM_FAIL = 70, /* UST create stream failed */
59 LTTNG_ERR_SNAPSHOT_NODATA = 71, /* No data in snapshot. */
60 LTTNG_ERR_MI_OUTPUT_TYPE = 91, /* Invalid MI output format */
61 LTTNG_ERR_MI_IO_FAIL = 92, /* IO error while writing machine interface output */
62 LTTNG_ERR_MI_NOT_IMPLEMENTED = 93, /* Mi feature not implemented */
63 LTTNG_ERR_EVENT_EXIST_LOGLEVEL = 100, /* Event enabled with different loglevel */
64 LTTNG_ERR_FILTER_EXIST = 108, /* Filter already exist */
65 LTTNG_ERR_COMMAND_CANCELLED = 128, /* Command cancelled. */
66 LTTNG_ERR_ROTATE_RENAME_FAIL_CONSUMER = 142, /* Rotation rename failure on consumer */
67 LTTNG_ERR_ROTATION_PENDING_LOCAL_FAIL_CONSUMER = 143, /* Rotation pending check (local)
68 failure on consumer */
69 LTTNG_ERR_ROTATION_PENDING_RELAY_FAIL_CONSUMER = 144, /* Rotation pending check (relay)
70 failure on consumer */
71 LTTNG_ERR_MKDIR_FAIL_CONSUMER = 145, /* mkdir failure on consumer */
72 LTTNG_ERR_TRACE_CHUNK_EXISTS_FAIL_CONSUMER = 151, /* failed to query consumer for trace
73 chunk existence */
75
78
81
84
90
93
96
99
102
105
111
114
117
123
126
133
136
139
142
145
148
151
154
157
160
163
166
169
172
175
178
181
187
190
193
196
202
208
211
214
220
226
229
232
239
242
249
252
258
261
264
270
276
279
282
285
288
291
294
297
304
310
317
323
329
332
339
345
351
357
363
369
375
381
382 /* 94 */
383 /* 95 */
384 /* 96 */
385
388
391
394
397
400
403
409
412
418
424
427
434
437
440
443
449
455
458
461
467
473
479
485
491
497
503
506
509
512
518
525
531
537
545
551
554
560
563
566
569
575
582
585
592
595
601
607
610
613
616
623
629
636
642
649
650 /* Unix user not found. */
651 LTTNG_ERR_USER_NOT_FOUND = 160,
652
653 /* Unix group not found. */
654 LTTNG_ERR_GROUP_NOT_FOUND = 161,
655
656 /* Unsupported \lt_obj_domain. */
657 LTTNG_ERR_UNSUPPORTED_DOMAIN = 162,
658
664
670
673
676
679
682
685
688
691
694
695 /* MUST be last element of the manually-assigned section of the enum */
697 LTTNG_ERR_NR,
699
700 /* Backward-compatibility assignments */
709
718};
719
735LTTNG_EXPORT extern const char *lttng_strerror(int error_code);
736
738
739#ifdef __cplusplus
740}
741#endif
742
743#endif /* LTTNG_ERROR_H */
lttng_error_code
General error codes.
Definition lttng-error.h:49
const char * lttng_strerror(int error_code)
Returns a human-readable message for the general error code error_code.
@ LTTNG_ERR_EXCLUSION_INVAL
Definition lttng-error.h:433
@ LTTNG_ERR_INVALID_PROTOCOL
Invalid protocol.
Definition lttng-error.h:609
@ LTTNG_ERR_NO_EVENT
Recording event rule not found.
Definition lttng-error.h:144
@ LTTNG_ERR_UNK
Unknown error.
Definition lttng-error.h:80
@ LTTNG_ERR_SNAPSHOT_FAIL
Definition lttng-error.h:225
@ LTTNG_ERR_UST_CONTEXT_EXIST
Definition lttng-error.h:303
@ LTTNG_ERR_UNKNOWN_DOMAIN
Unknown tracing domain.
Definition lttng-error.h:92
@ LTTNG_ERR_NO_CHANNEL
Recording session has no channels.
Definition lttng-error.h:284
@ LTTNG_ERR_KERN_EVENT_ENOSYS
Linux kernel instrumentation point type not supported.
Definition lttng-error.h:331
@ LTTNG_ERR_SESSION_INVALID_CHAR
Recording session name contains an invalid character.
Definition lttng-error.h:287
@ LTTNG_ERR_PID_TRACKED
Definition lttng-error.h:708
@ LTTNG_ERR_KERN_EVENT_EXIST
Linux kernel recording event rule already exists.
Definition lttng-error.h:162
@ LTTNG_ERR_UND
Undefined command.
Definition lttng-error.h:83
@ LTTNG_ERR_URL_DATA_MISS
Missing network data URL.
Definition lttng-error.h:396
@ LTTNG_ERR_KERN_LIST_FAIL
Failed to list Linux kernel recording event rules.
Definition lttng-error.h:228
@ LTTNG_ERR_AGENT_TRACING_DISABLED
Unavailable logging instrumentation point feature.
Definition lttng-error.h:562
@ LTTNG_ERR_ROTATION_PENDING
Definition lttng-error.h:517
@ LTTNG_ERR_INVALID_CHANNEL_NAME
Invalid channel name.
Definition lttng-error.h:442
@ LTTNG_ERR_UST_CHAN_EXIST
User space channel already exists.
Definition lttng-error.h:241
@ LTTNG_ERR_UST_ENABLE_FAIL
Failed to create/enable a user space recording event rule.
Definition lttng-error.h:260
@ LTTNG_ERR_KERN_CONTEXT_UNAVAILABLE
Definition lttng-error.h:484
@ LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING_FULL
Event notifier error accouting is full.
Definition lttng-error.h:681
@ LTTNG_ERR_UST_DISABLE_FAIL
Failed to disable a user space recording event rule.
Definition lttng-error.h:263
@ LTTNG_ERR_EXIST_SESS
Recording session name already exists.
Definition lttng-error.h:141
@ LTTNG_ERR_INVALID_CHANNEL_DOMAIN
Invalid tracing domain for channel.
Definition lttng-error.h:457
@ LTTNG_ERR_INVALID_RECLAMATION_POLICY
Invalid reclamation policy.
Definition lttng-error.h:690
@ LTTNG_ERR_KERN_SESS_FAIL
Linux kernel tracer: failed to create a recording session.
Definition lttng-error.h:165
@ LTTNG_ERR_KERN_CHAN_DISABLE_FAIL
Failed to disable a Linux kernel channel.
Definition lttng-error.h:177
@ LTTNG_ERR_PROCESS_ATTR_TRACKER_INVALID_TRACKING_POLICY
Definition lttng-error.h:663
@ LTTNG_ERR_CREATE_TRACE_CHUNK_FAIL_CONSUMER
Definition lttng-error.h:600
@ LTTNG_ERR_TRIGGER_EXISTS
Trigger already exists (registered).
Definition lttng-error.h:508
@ LTTNG_ERR_UST_CONSUMER64_FAIL
Failed to start a 64-bit user space consumer daemon.
Definition lttng-error.h:278
@ LTTNG_ERR_NEED_CHANNEL_NAME
Definition lttng-error.h:338
@ LTTNG_ERR_NEED_ROOT_SESSIOND
Definition lttng-error.h:316
@ LTTNG_ERR_PID_NOT_TRACKED
Definition lttng-error.h:717
@ LTTNG_ERR_TRIGGER_NOT_FOUND
Trigger not found.
Definition lttng-error.h:511
@ LTTNG_ERR_INVALID_ERROR_QUERY_TARGET
Invalid error query target.
Definition lttng-error.h:684
@ LTTNG_ERR_UNSUPPORTED_TRACE_FORMAT
Trace format is not supported.
Definition lttng-error.h:693
@ LTTNG_ERR_TIMER_STOP_ERROR
Failed to stop a timer.
Definition lttng-error.h:615
@ LTTNG_ERR_CLEAR_FAIL_CONSUMER
Definition lttng-error.h:641
@ LTTNG_ERR_KERN_STOP_FAIL
Definition lttng-error.h:207
@ LTTNG_ERR_EXCLUSION_NOMEM
Failed to allocate memory for an event name exclusion object.
Definition lttng-error.h:436
@ LTTNG_ERR_NO_UST
Definition lttng-error.h:344
@ LTTNG_ERR_PROBE_LOCATION_INVAL
Invalid user space probe location.
Definition lttng-error.h:565
@ LTTNG_ERR_ROTATION_NOT_AVAILABLE_KERNEL
Definition lttng-error.h:622
@ LTTNG_ERR_CONNECT_FAIL
Failed to connect to Unix socket.
Definition lttng-error.h:147
@ LTTNG_ERR_BUFFER_FLUSH_FAILED
Failed to flush a buffer.
Definition lttng-error.h:687
@ LTTNG_ERR_INVALID
Unsatisfied precondition (invalid parameter, for example).
Definition lttng-error.h:387
@ LTTNG_ERR_ELF_PARSING
Failed to parse ELF file.
Definition lttng-error.h:568
@ LTTNG_ERR_ROTATION_WRONG_VERSION
Definition lttng-error.h:550
@ LTTNG_ERR_BUFFER_NOT_SUPPORTED
Definition lttng-error.h:122
@ LTTNG_ERR_UST_CHAN_DISABLE_FAIL
Definition lttng-error.h:257
@ LTTNG_ERR_KERN_CHAN_FAIL
Failed to create a Linux kernel channel.
Definition lttng-error.h:171
@ LTTNG_ERR_NO_SESSION
No recording session found.
Definition lttng-error.h:98
@ LTTNG_ERR_UST_CONSUMER32_FAIL
Failed to start a 32-bit user space consumer daemon.
Definition lttng-error.h:281
@ LTTNG_ERR_TRACE_ALREADY_STARTED
Definition lttng-error.h:322
@ LTTNG_ERR_CREATE_DIR_FAIL
Failed to create a directory.
Definition lttng-error.h:101
@ LTTNG_OK
Success.
Definition lttng-error.h:77
@ LTTNG_ERR_KERN_VERSION
Incompatible Linux kernel tracer.
Definition lttng-error.h:159
@ LTTNG_ERR_URL_CTRL_MISS
Missing network control URL.
Definition lttng-error.h:399
@ LTTNG_ERR_SNAPSHOT_UNSUPPORTED
Definition lttng-error.h:591
@ LTTNG_ERR_UST_EVENT_NOT_FOUND
User space recording event rule not found.
Definition lttng-error.h:296
@ LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST
Snapshot output already exists.
Definition lttng-error.h:150
@ LTTNG_ERR_REGEN_STATEDUMP_NOMEM
Definition lttng-error.h:496
@ LTTNG_ERR_KERN_META_FAIL
Failed to open a Linux kernel trace metadata stream.
Definition lttng-error.h:195
@ LTTNG_ERR_NO_CONSUMER
No available consumer daemon.
Definition lttng-error.h:426
@ LTTNG_ERR_FATAL
Fatal error.
Definition lttng-error.h:135
@ LTTNG_ERR_KERN_CHAN_EXIST
Linux kernel channel already exists.
Definition lttng-error.h:168
@ LTTNG_ERR_SAVE_IO_FAIL
Definition lttng-error.h:356
@ LTTNG_ERR_KERN_CHAN_NOT_FOUND
Linux kernel channel not found.
Definition lttng-error.h:174
@ LTTNG_ERR_INVALID_EVENT_NAME
Invalid event name condition part of a recording event rule.
Definition lttng-error.h:439
@ LTTNG_ERR_TRACE_ALREADY_STOPPED
Definition lttng-error.h:328
@ LTTNG_ERR_KERN_DISABLE_FAIL
Failed to disable a Linux kernel recording event rule.
Definition lttng-error.h:192
@ LTTNG_ERR_ROTATION_AFTER_STOP_CLEAR
Definition lttng-error.h:648
@ LTTNG_ERR_RELAYD_VERSION_FAIL
Incompatible relay daemon (see lttng-relayd(8)) version.
Definition lttng-error.h:411
@ LTTNG_ERR_UST_SESS_FAIL
Definition lttng-error.h:238
@ LTTNG_ERR_PROCESS_ATTR_MISSING
Definition lttng-error.h:454
@ LTTNG_ERR_ROTATION_SCHEDULE_NOT_SET
Definition lttng-error.h:536
@ LTTNG_ERR_NO_KERNCONSUMERD
No Linux kernel consumer daemon available.
Definition lttng-error.h:393
@ LTTNG_ERR_START_SESSION_ONCE
Definition lttng-error.h:219
@ LTTNG_ERR_LOAD_SESSION_NOENT
Definition lttng-error.h:374
@ LTTNG_ERR_NO_SESSION_OUTPUT
Recording session has no configured output.
Definition lttng-error.h:553
@ LTTNG_ERR_ENABLE_CONSUMER_FAIL
Failed to communicate with a consumer daemon.
Definition lttng-error.h:402
@ LTTNG_ERR_CLEAR_NOT_AVAILABLE_RELAY
Definition lttng-error.h:635
@ LTTNG_ERR_UST_STOP_FAIL
Definition lttng-error.h:275
@ LTTNG_ERR_KERN_NA
Linux kernel tracer isn't available.
Definition lttng-error.h:156
@ LTTNG_ERR_REGEN_STATEDUMP_FAIL
Definition lttng-error.h:490
@ LTTNG_ERR_EVENT_NOTIFIER_GROUP_NOTIFICATION_FD
Definition lttng-error.h:669
@ LTTNG_ERR_SAVE_FILE_EXIST
Definition lttng-error.h:350
@ LTTNG_ERR_SESSION_NOT_EXIST
Nonexistent recording session.
Definition lttng-error.h:594
@ LTTNG_ERR_RELAYD_CONNECT_FAIL
Definition lttng-error.h:408
@ LTTNG_ERR_ROTATION_MULTIPLE_AFTER_STOP
Definition lttng-error.h:544
@ LTTNG_ERR_UST_EVENT_ENABLED
User space recording event rule already enabled.
Definition lttng-error.h:231
@ LTTNG_ERR_CLOSE_TRACE_CHUNK_FAIL_CONSUMER
Definition lttng-error.h:606
@ LTTNG_ERR_FILTER_INVAL
Definition lttng-error.h:417
@ LTTNG_ERR_SET_URL
Failed to set an URL.
Definition lttng-error.h:113
@ LTTNG_ERR_UST_EVENT_EXIST
User space recording event rule already exists.
Definition lttng-error.h:293
@ LTTNG_ERR_NO_USTCONSUMERD
No user space consumer daemon available.
Definition lttng-error.h:390
@ LTTNG_ERR_ROTATION_NOT_AVAILABLE_RELAY
Definition lttng-error.h:559
@ LTTNG_ERR_CHAN_NOT_FOUND
Channel not found.
Definition lttng-error.h:584
@ LTTNG_ERR_SESS_NOT_FOUND
Nonexistent recording session name.
Definition lttng-error.h:125
@ LTTNG_ERR_KERN_CONSUMER_FAIL
Failed to start a Linux kernel consumer daemon.
Definition lttng-error.h:210
@ LTTNG_ERR_EVENT_NOTIFIER_ERROR_ACCOUNTING
Failed to initialize the event notifier error accounting.
Definition lttng-error.h:678
@ LTTNG_ERR_OVERFLOW
Overflow.
Definition lttng-error.h:460
@ LTTNG_ERR_ROTATION_FAIL_CONSUMER
Definition lttng-error.h:581
@ LTTNG_ERR_PROCESS_ATTR_EXISTS
Definition lttng-error.h:448
@ LTTNG_ERR_KERN_START_FAIL
Definition lttng-error.h:201
@ LTTNG_ERR_UST_LIST_FAIL
Failed to list user space recording event rules.
Definition lttng-error.h:290
@ LTTNG_ERR_NO_SESSIOND
Definition lttng-error.h:110
@ LTTNG_ERR_INVALID_TRIGGER
Invalid trigger.
Definition lttng-error.h:505
@ LTTNG_ERR_SESSION_FAIL
Failed to create a recording session.
Definition lttng-error.h:104
@ LTTNG_ERR_SESSION_STARTED
Definition lttng-error.h:89
@ LTTNG_ERR_UST_START_FAIL
Definition lttng-error.h:269
@ LTTNG_ERR_URL_EXIST
URL already exists.
Definition lttng-error.h:116
@ LTTNG_ERR_KERN_STREAM_FAIL
Failed to create a Linux kernel trace data stream.
Definition lttng-error.h:213
@ LTTNG_ERR_MAX_SIZE_INVALID
Definition lttng-error.h:380
@ LTTNG_ERR_PER_PID_SESSION
Definition lttng-error.h:478
@ LTTNG_ERR_EPERM
Permission denied.
Definition lttng-error.h:153
@ LTTNG_ERR_KERN_CONTEXT_FAIL
Definition lttng-error.h:186
@ LTTNG_ERR_NOT_SNAPSHOT_SESSION
Definition lttng-error.h:502
@ LTTNG_ERR_EVENT_NOTIFIER_REGISTRATION
Failed to register the event notifier to the tracer.
Definition lttng-error.h:675
@ LTTNG_ERR_SDT_PROBE_SEMAPHORE
Definition lttng-error.h:574
@ LTTNG_ERR_KERN_ENABLE_FAIL
Failed to create/enable a Linux kernel recording event rule.
Definition lttng-error.h:189
@ LTTNG_ERR_LOAD_INVALID_CONFIG
Definition lttng-error.h:362
@ LTTNG_ERR_INVALID_CAPTURE_EXPRESSION
Invalid event field capture expression.
Definition lttng-error.h:672
@ LTTNG_ERR_LIVE_SESSION
Definition lttng-error.h:472
@ LTTNG_ERR_LOAD_IO_FAIL
Definition lttng-error.h:368
@ LTTNG_ERR_KERN_CHAN_ENABLE_FAIL
Failed to create/enable a Linux kernel channel.
Definition lttng-error.h:180
@ LTTNG_ERR_NOT_SUPPORTED
Unsupported operation.
Definition lttng-error.h:95
@ LTTNG_ERR_FILE_CREATION_ERROR
Failed to create a file.
Definition lttng-error.h:612
@ LTTNG_ERR_NOMEM
Failed to allocate memory.
Definition lttng-error.h:138
@ LTTNG_ERR_ROTATION_SCHEDULE_SET
Definition lttng-error.h:530
@ LTTNG_ERR_UST_CHAN_FAIL
Definition lttng-error.h:248
@ LTTNG_ERR_CLEAR_RELAY_DISALLOWED
Definition lttng-error.h:628
@ LTTNG_ERR_UST_CHAN_NOT_FOUND
User space channel not found.
Definition lttng-error.h:251
@ LTTNG_ERR_BUFFER_TYPE_MISMATCH
Definition lttng-error.h:132
@ LTTNG_ERR_FILTER_NOMEM
Definition lttng-error.h:423
@ LTTNG_ERR_UST_CONTEXT_INVAL
Definition lttng-error.h:309
@ LTTNG_ERR_ROTATION_NOT_AVAILABLE
Definition lttng-error.h:524
@ LTTNG_ERR_SESSION_NOT_STARTED
Definition lttng-error.h:466