Split lttng.h into several files

[lttng-tools.git] / include / lttng / lttng-error.h

diff --git a/include/lttng/lttng-error.h b/include/lttng/lttng-error.h
index 9cb74a12237d82298a4caf0b78f22b01510036e3..f4f3a8344d79085d1e1f50a03637c60dfd98df52 100644 (file)
--- a/include/lttng/lttng-error.h
+++ b/include/lttng/lttng-error.h
@@ -40,18 +40,18 @@ enum lttng_error_code {
        LTTNG_ERR_CREATE_DIR_FAIL        = 17,  /* Create directory fail */
        LTTNG_ERR_SESSION_FAIL           = 18,  /* Create session fail */
        LTTNG_ERR_NO_SESSIOND            = 19,  /* No session daemon available */
-       /* 20 */
-       /* 21 */
-       /* 22 */
+       LTTNG_ERR_SET_URL                = 20,  /* Error setting URL */
+       LTTNG_ERR_URL_EXIST              = 21,  /* URL already exists. */
+       LTTNG_ERR_BUFFER_NOT_SUPPORTED   = 22,  /* Buffer type not supported. */
        LTTNG_ERR_SESS_NOT_FOUND         = 23,  /* Session by name not found */
-       /* 24 */
+       LTTNG_ERR_BUFFER_TYPE_MISMATCH   = 24,  /* Buffer type mismatched. */
        LTTNG_ERR_FATAL                  = 25,  /* Fatal error */
-       /* 26 */
+       LTTNG_ERR_NOMEM                  = 26,  /* Not enough memory. */
        LTTNG_ERR_SELECT_SESS            = 27,  /* Must select a session */
        LTTNG_ERR_EXIST_SESS             = 28,  /* Session name already exist */
        LTTNG_ERR_NO_EVENT               = 29,  /* No event found */
        LTTNG_ERR_CONNECT_FAIL           = 30,  /* Unable to connect to unix socket */
-       /* 31 */
+       LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST  = 31,  /* Snapshot output already exists */
        LTTNG_ERR_EPERM                  = 32,  /* Permission denied */
        LTTNG_ERR_KERN_NA                = 33,  /* Kernel tracer unavalable */
        LTTNG_ERR_KERN_VERSION           = 34,  /* Kernel tracer not compatible */
@@ -70,9 +70,9 @@ enum lttng_error_code {
        LTTNG_ERR_KERN_STOP_FAIL         = 47,  /* Kernel stop trace failed */
        LTTNG_ERR_KERN_CONSUMER_FAIL     = 48,  /* Kernel consumer start failed */
        LTTNG_ERR_KERN_STREAM_FAIL       = 49,  /* Kernel create stream failed */
-       /* 50 */
-       /* 51 */
-       /* 52 */
+       LTTNG_ERR_START_SESSION_ONCE     = 50,  /* Session needs to be started once. */
+       LTTNG_ERR_SNAPSHOT_FAIL          = 51,  /* Snapshot record failed. */
+       LTTNG_ERR_NO_STREAM              = 52,  /* Index without stream on relay. */
        LTTNG_ERR_KERN_LIST_FAIL         = 53,  /* Kernel listing events failed */
        LTTNG_ERR_UST_CALIBRATE_FAIL     = 54,  /* UST calibration failed */
        LTTNG_ERR_UST_EVENT_ENABLED      = 55,  /* UST event already enabled. */
@@ -82,7 +82,7 @@ enum lttng_error_code {
        LTTNG_ERR_UST_CHAN_NOT_FOUND     = 59,  /* UST channel not found */
        LTTNG_ERR_UST_CHAN_DISABLE_FAIL  = 60,  /* UST disable channel failed */
        LTTNG_ERR_UST_CHAN_ENABLE_FAIL   = 61,  /* UST enable channel failed */
-       /* 62 */
+       LTTNG_ERR_CHAN_EXIST             = 62,  /* Channel already exists. */
        LTTNG_ERR_UST_ENABLE_FAIL        = 63,  /* UST enable event failed */
        LTTNG_ERR_UST_DISABLE_FAIL       = 64,  /* UST disable event failed */
        LTTNG_ERR_UST_META_FAIL          = 65,  /* UST open metadata failed */
@@ -91,9 +91,9 @@ enum lttng_error_code {
        LTTNG_ERR_UST_CONSUMER64_FAIL    = 68,  /* 64-bit UST consumer start failed */
        LTTNG_ERR_UST_CONSUMER32_FAIL    = 69,  /* 32-bit UST consumer start failed */
        LTTNG_ERR_UST_STREAM_FAIL        = 70,  /* UST create stream failed */
-       /* 71 */
-       /* 72 */
-       /* 73 */
+       LTTNG_ERR_SNAPSHOT_NODATA        = 71,  /* No data in snapshot. */
+       LTTNG_ERR_NO_CHANNEL             = 72,  /* No channel found in the session. */
+       LTTNG_ERR_SESSION_INVALID_CHAR   = 73,  /* Invalid characters found in session name. */
        LTTNG_ERR_UST_LIST_FAIL          = 74,  /* UST listing events failed */
        LTTNG_ERR_UST_EVENT_EXIST        = 75,  /* UST event exist */
        LTTNG_ERR_UST_EVENT_NOT_FOUND    = 76,  /* UST event not found */
@@ -103,13 +103,13 @@ enum lttng_error_code {
        LTTNG_ERR_TRACE_ALREADY_STARTED  = 80,  /* Tracing already started */
        LTTNG_ERR_TRACE_ALREADY_STOPPED  = 81,  /* Tracing already stopped */
        LTTNG_ERR_KERN_EVENT_ENOSYS      = 82,  /* Kernel event type not supported */
-       /* 83 */
-       /* 84 */
-       /* 85 */
-       /* 86 */
-       /* 87 */
-       /* 88 */
-       /* 89 */
+       LTTNG_ERR_NEED_CHANNEL_NAME      = 83,  /* Non-default channel exists within session: channel name needs to be specified with '-c name' */
+       LTTNG_ERR_NO_UST                 = 84,  /* LTTng-UST tracer is not supported. Please rebuild lttng-tools with lttng-ust support enabled. */
+       LTTNG_ERR_SAVE_FILE_EXIST        = 85,  /* Session file already exists. */
+       LTTNG_ERR_SAVE_IO_FAIL           = 86,  /* IO error while writting session configuration */
+       LTTNG_ERR_LOAD_INVALID_CONFIG    = 87,  /* Invalid session configuration */
+       LTTNG_ERR_LOAD_IO_FAIL           = 88,  /* IO error while reading a session configuration */
+       LTTNG_ERR_LOAD_SESSION_NOENT     = 89,  /* Session file not found */
        /* 90 */
        /* 91 */
        /* 92 */
@@ -130,11 +130,20 @@ enum lttng_error_code {
        LTTNG_ERR_FILTER_NOMEM           = 107, /* Lack of memory for filter bytecode */
        LTTNG_ERR_FILTER_EXIST           = 108, /* Filter already exist */
        LTTNG_ERR_NO_CONSUMER            = 109, /* No consumer exist for the session */
+       LTTNG_ERR_EXCLUSION_INVAL        = 110, /* Invalid event exclusion data */
+       LTTNG_ERR_EXCLUSION_NOMEM        = 111, /* Lack of memory while processing event exclusions */
 
        /* MUST be last element */
        LTTNG_ERR_NR,                           /* Last element */
 };
 
+/*
+ * Return a human-readable error message for a LTTng error code.
+ *
+ * Parameter MUST be a negative value or else you'll get a generic message.
+ */
+extern const char *lttng_strerror(int code);
+
 #ifdef __cplusplus
 }
 #endif