X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Fevent.h;fp=include%2Flttng%2Fevent.h;h=202fd8992deb47eb4ab501bae9ce505afd8cb518;hp=5915db6d6738632d126ad2b0369f78d84256e215;hb=28f23191dcbf047429d51950a337a57d7a3f866a;hpb=f250b40e2179eccdb83766bf4abef5a35036c47b diff --git a/include/lttng/event.h b/include/lttng/event.h index 5915db6d6..202fd8992 100644 --- a/include/lttng/event.h +++ b/include/lttng/event.h @@ -21,44 +21,44 @@ extern "C" { * Instrumentation type of tracing event. */ enum lttng_event_type { - LTTNG_EVENT_ALL = -1, - LTTNG_EVENT_TRACEPOINT = 0, - LTTNG_EVENT_PROBE = 1, - LTTNG_EVENT_FUNCTION = 2, - LTTNG_EVENT_FUNCTION_ENTRY = 3, - LTTNG_EVENT_NOOP = 4, - LTTNG_EVENT_SYSCALL = 5, - LTTNG_EVENT_USERSPACE_PROBE = 6, + LTTNG_EVENT_ALL = -1, + LTTNG_EVENT_TRACEPOINT = 0, + LTTNG_EVENT_PROBE = 1, + LTTNG_EVENT_FUNCTION = 2, + LTTNG_EVENT_FUNCTION_ENTRY = 3, + LTTNG_EVENT_NOOP = 4, + LTTNG_EVENT_SYSCALL = 5, + LTTNG_EVENT_USERSPACE_PROBE = 6, }; /* * Loglevel information. */ enum lttng_loglevel_type { - LTTNG_EVENT_LOGLEVEL_ALL = 0, - LTTNG_EVENT_LOGLEVEL_RANGE = 1, - LTTNG_EVENT_LOGLEVEL_SINGLE = 2, + LTTNG_EVENT_LOGLEVEL_ALL = 0, + LTTNG_EVENT_LOGLEVEL_RANGE = 1, + LTTNG_EVENT_LOGLEVEL_SINGLE = 2, }; /* * Available loglevels. */ enum lttng_loglevel { - LTTNG_LOGLEVEL_EMERG = 0, - LTTNG_LOGLEVEL_ALERT = 1, - LTTNG_LOGLEVEL_CRIT = 2, - LTTNG_LOGLEVEL_ERR = 3, - LTTNG_LOGLEVEL_WARNING = 4, - LTTNG_LOGLEVEL_NOTICE = 5, - LTTNG_LOGLEVEL_INFO = 6, - LTTNG_LOGLEVEL_DEBUG_SYSTEM = 7, - LTTNG_LOGLEVEL_DEBUG_PROGRAM = 8, - LTTNG_LOGLEVEL_DEBUG_PROCESS = 9, - LTTNG_LOGLEVEL_DEBUG_MODULE = 10, - LTTNG_LOGLEVEL_DEBUG_UNIT = 11, - LTTNG_LOGLEVEL_DEBUG_FUNCTION = 12, - LTTNG_LOGLEVEL_DEBUG_LINE = 13, - LTTNG_LOGLEVEL_DEBUG = 14, + LTTNG_LOGLEVEL_EMERG = 0, + LTTNG_LOGLEVEL_ALERT = 1, + LTTNG_LOGLEVEL_CRIT = 2, + LTTNG_LOGLEVEL_ERR = 3, + LTTNG_LOGLEVEL_WARNING = 4, + LTTNG_LOGLEVEL_NOTICE = 5, + LTTNG_LOGLEVEL_INFO = 6, + LTTNG_LOGLEVEL_DEBUG_SYSTEM = 7, + LTTNG_LOGLEVEL_DEBUG_PROGRAM = 8, + LTTNG_LOGLEVEL_DEBUG_PROCESS = 9, + LTTNG_LOGLEVEL_DEBUG_MODULE = 10, + LTTNG_LOGLEVEL_DEBUG_UNIT = 11, + LTTNG_LOGLEVEL_DEBUG_FUNCTION = 12, + LTTNG_LOGLEVEL_DEBUG_LINE = 13, + LTTNG_LOGLEVEL_DEBUG = 14, }; /* @@ -66,15 +66,15 @@ enum lttng_loglevel { * class java.util.logging.Level. */ enum lttng_loglevel_jul { - LTTNG_LOGLEVEL_JUL_OFF = INT32_MAX, - LTTNG_LOGLEVEL_JUL_SEVERE = 1000, - LTTNG_LOGLEVEL_JUL_WARNING = 900, - LTTNG_LOGLEVEL_JUL_INFO = 800, - LTTNG_LOGLEVEL_JUL_CONFIG = 700, - LTTNG_LOGLEVEL_JUL_FINE = 500, - LTTNG_LOGLEVEL_JUL_FINER = 400, - LTTNG_LOGLEVEL_JUL_FINEST = 300, - LTTNG_LOGLEVEL_JUL_ALL = INT32_MIN, + LTTNG_LOGLEVEL_JUL_OFF = INT32_MAX, + LTTNG_LOGLEVEL_JUL_SEVERE = 1000, + LTTNG_LOGLEVEL_JUL_WARNING = 900, + LTTNG_LOGLEVEL_JUL_INFO = 800, + LTTNG_LOGLEVEL_JUL_CONFIG = 700, + LTTNG_LOGLEVEL_JUL_FINE = 500, + LTTNG_LOGLEVEL_JUL_FINER = 400, + LTTNG_LOGLEVEL_JUL_FINEST = 300, + LTTNG_LOGLEVEL_JUL_ALL = INT32_MIN, }; /* @@ -82,14 +82,14 @@ enum lttng_loglevel_jul { * class org.apache.log4j.Level. */ enum lttng_loglevel_log4j { - LTTNG_LOGLEVEL_LOG4J_OFF = INT32_MAX, - LTTNG_LOGLEVEL_LOG4J_FATAL = 50000, - LTTNG_LOGLEVEL_LOG4J_ERROR = 40000, - LTTNG_LOGLEVEL_LOG4J_WARN = 30000, - LTTNG_LOGLEVEL_LOG4J_INFO = 20000, - LTTNG_LOGLEVEL_LOG4J_DEBUG = 10000, - LTTNG_LOGLEVEL_LOG4J_TRACE = 5000, - LTTNG_LOGLEVEL_LOG4J_ALL = INT32_MIN, + LTTNG_LOGLEVEL_LOG4J_OFF = INT32_MAX, + LTTNG_LOGLEVEL_LOG4J_FATAL = 50000, + LTTNG_LOGLEVEL_LOG4J_ERROR = 40000, + LTTNG_LOGLEVEL_LOG4J_WARN = 30000, + LTTNG_LOGLEVEL_LOG4J_INFO = 20000, + LTTNG_LOGLEVEL_LOG4J_DEBUG = 10000, + LTTNG_LOGLEVEL_LOG4J_TRACE = 5000, + LTTNG_LOGLEVEL_LOG4J_ALL = INT32_MIN, }; /* @@ -97,79 +97,79 @@ enum lttng_loglevel_log4j { * Level class. */ enum lttng_loglevel_python { - LTTNG_LOGLEVEL_PYTHON_CRITICAL = 50, - LTTNG_LOGLEVEL_PYTHON_ERROR = 40, - LTTNG_LOGLEVEL_PYTHON_WARNING = 30, - LTTNG_LOGLEVEL_PYTHON_INFO = 20, - LTTNG_LOGLEVEL_PYTHON_DEBUG = 10, - LTTNG_LOGLEVEL_PYTHON_NOTSET = 0, + LTTNG_LOGLEVEL_PYTHON_CRITICAL = 50, + LTTNG_LOGLEVEL_PYTHON_ERROR = 40, + LTTNG_LOGLEVEL_PYTHON_WARNING = 30, + LTTNG_LOGLEVEL_PYTHON_INFO = 20, + LTTNG_LOGLEVEL_PYTHON_DEBUG = 10, + LTTNG_LOGLEVEL_PYTHON_NOTSET = 0, }; /* * LTTng consumer mode */ enum lttng_event_output { - LTTNG_EVENT_SPLICE = 0, - LTTNG_EVENT_MMAP = 1, + LTTNG_EVENT_SPLICE = 0, + LTTNG_EVENT_MMAP = 1, }; /* Event context possible type */ enum lttng_event_context_type { - LTTNG_EVENT_CONTEXT_PID = 0, - LTTNG_EVENT_CONTEXT_PERF_COUNTER = 1, /* Backward compat. */ - LTTNG_EVENT_CONTEXT_PROCNAME = 2, - LTTNG_EVENT_CONTEXT_PRIO = 3, - LTTNG_EVENT_CONTEXT_NICE = 4, - LTTNG_EVENT_CONTEXT_VPID = 5, - LTTNG_EVENT_CONTEXT_TID = 6, - LTTNG_EVENT_CONTEXT_VTID = 7, - LTTNG_EVENT_CONTEXT_PPID = 8, - LTTNG_EVENT_CONTEXT_VPPID = 9, - LTTNG_EVENT_CONTEXT_PTHREAD_ID = 10, - LTTNG_EVENT_CONTEXT_HOSTNAME = 11, - LTTNG_EVENT_CONTEXT_IP = 12, - LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER = 13, + LTTNG_EVENT_CONTEXT_PID = 0, + LTTNG_EVENT_CONTEXT_PERF_COUNTER = 1, /* Backward compat. */ + LTTNG_EVENT_CONTEXT_PROCNAME = 2, + LTTNG_EVENT_CONTEXT_PRIO = 3, + LTTNG_EVENT_CONTEXT_NICE = 4, + LTTNG_EVENT_CONTEXT_VPID = 5, + LTTNG_EVENT_CONTEXT_TID = 6, + LTTNG_EVENT_CONTEXT_VTID = 7, + LTTNG_EVENT_CONTEXT_PPID = 8, + LTTNG_EVENT_CONTEXT_VPPID = 9, + LTTNG_EVENT_CONTEXT_PTHREAD_ID = 10, + LTTNG_EVENT_CONTEXT_HOSTNAME = 11, + LTTNG_EVENT_CONTEXT_IP = 12, + LTTNG_EVENT_CONTEXT_PERF_CPU_COUNTER = 13, LTTNG_EVENT_CONTEXT_PERF_THREAD_COUNTER = 14, - LTTNG_EVENT_CONTEXT_APP_CONTEXT = 15, - LTTNG_EVENT_CONTEXT_INTERRUPTIBLE = 16, - LTTNG_EVENT_CONTEXT_PREEMPTIBLE = 17, - LTTNG_EVENT_CONTEXT_NEED_RESCHEDULE = 18, - LTTNG_EVENT_CONTEXT_MIGRATABLE = 19, - LTTNG_EVENT_CONTEXT_CALLSTACK_KERNEL = 20, - LTTNG_EVENT_CONTEXT_CALLSTACK_USER = 21, /* Supported on x86_32 and x86_64 only. */ - LTTNG_EVENT_CONTEXT_CGROUP_NS = 22, - LTTNG_EVENT_CONTEXT_IPC_NS = 23, - LTTNG_EVENT_CONTEXT_MNT_NS = 24, - LTTNG_EVENT_CONTEXT_NET_NS = 25, - LTTNG_EVENT_CONTEXT_PID_NS = 26, - LTTNG_EVENT_CONTEXT_USER_NS = 27, - LTTNG_EVENT_CONTEXT_UTS_NS = 28, - LTTNG_EVENT_CONTEXT_UID = 29, - LTTNG_EVENT_CONTEXT_EUID = 30, - LTTNG_EVENT_CONTEXT_SUID = 31, - LTTNG_EVENT_CONTEXT_GID = 32, - LTTNG_EVENT_CONTEXT_EGID = 33, - LTTNG_EVENT_CONTEXT_SGID = 34, - LTTNG_EVENT_CONTEXT_VUID = 35, - LTTNG_EVENT_CONTEXT_VEUID = 36, - LTTNG_EVENT_CONTEXT_VSUID = 37, - LTTNG_EVENT_CONTEXT_VGID = 38, - LTTNG_EVENT_CONTEXT_VEGID = 39, - LTTNG_EVENT_CONTEXT_VSGID = 40, - LTTNG_EVENT_CONTEXT_TIME_NS = 41, + LTTNG_EVENT_CONTEXT_APP_CONTEXT = 15, + LTTNG_EVENT_CONTEXT_INTERRUPTIBLE = 16, + LTTNG_EVENT_CONTEXT_PREEMPTIBLE = 17, + LTTNG_EVENT_CONTEXT_NEED_RESCHEDULE = 18, + LTTNG_EVENT_CONTEXT_MIGRATABLE = 19, + LTTNG_EVENT_CONTEXT_CALLSTACK_KERNEL = 20, + LTTNG_EVENT_CONTEXT_CALLSTACK_USER = 21, /* Supported on x86_32 and x86_64 only. */ + LTTNG_EVENT_CONTEXT_CGROUP_NS = 22, + LTTNG_EVENT_CONTEXT_IPC_NS = 23, + LTTNG_EVENT_CONTEXT_MNT_NS = 24, + LTTNG_EVENT_CONTEXT_NET_NS = 25, + LTTNG_EVENT_CONTEXT_PID_NS = 26, + LTTNG_EVENT_CONTEXT_USER_NS = 27, + LTTNG_EVENT_CONTEXT_UTS_NS = 28, + LTTNG_EVENT_CONTEXT_UID = 29, + LTTNG_EVENT_CONTEXT_EUID = 30, + LTTNG_EVENT_CONTEXT_SUID = 31, + LTTNG_EVENT_CONTEXT_GID = 32, + LTTNG_EVENT_CONTEXT_EGID = 33, + LTTNG_EVENT_CONTEXT_SGID = 34, + LTTNG_EVENT_CONTEXT_VUID = 35, + LTTNG_EVENT_CONTEXT_VEUID = 36, + LTTNG_EVENT_CONTEXT_VSUID = 37, + LTTNG_EVENT_CONTEXT_VGID = 38, + LTTNG_EVENT_CONTEXT_VEGID = 39, + LTTNG_EVENT_CONTEXT_VSGID = 40, + LTTNG_EVENT_CONTEXT_TIME_NS = 41, }; enum lttng_event_field_type { - LTTNG_EVENT_FIELD_OTHER = 0, - LTTNG_EVENT_FIELD_INTEGER = 1, - LTTNG_EVENT_FIELD_ENUM = 2, - LTTNG_EVENT_FIELD_FLOAT = 3, - LTTNG_EVENT_FIELD_STRING = 4, + LTTNG_EVENT_FIELD_OTHER = 0, + LTTNG_EVENT_FIELD_INTEGER = 1, + LTTNG_EVENT_FIELD_ENUM = 2, + LTTNG_EVENT_FIELD_FLOAT = 3, + LTTNG_EVENT_FIELD_STRING = 4, }; enum lttng_event_flag { - LTTNG_EVENT_FLAG_SYSCALL_32 = (1U << 0), - LTTNG_EVENT_FLAG_SYSCALL_64 = (1U << 1), + LTTNG_EVENT_FLAG_SYSCALL_32 = (1U << 0), + LTTNG_EVENT_FLAG_SYSCALL_64 = (1U << 1), }; /* @@ -177,7 +177,7 @@ enum lttng_event_flag { * * The structures should be initialized to zero before use. */ -#define LTTNG_PERF_EVENT_PADDING1 16 +#define LTTNG_PERF_EVENT_PADDING1 16 struct lttng_event_perf_counter_ctx { uint32_t type; uint64_t config; @@ -191,8 +191,8 @@ struct lttng_event_perf_counter_ctx { * * The structures should be initialized to zero before use. */ -#define LTTNG_EVENT_CONTEXT_PADDING1 16 -#define LTTNG_EVENT_CONTEXT_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32 +#define LTTNG_EVENT_CONTEXT_PADDING1 16 +#define LTTNG_EVENT_CONTEXT_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32 struct lttng_event_context { enum lttng_event_context_type ctx; char padding[LTTNG_EVENT_CONTEXT_PADDING1]; @@ -214,7 +214,7 @@ struct lttng_event_context { * * The structures should be initialized to zero before use. */ -#define LTTNG_EVENT_PROBE_PADDING1 16 +#define LTTNG_EVENT_PROBE_PADDING1 16 struct lttng_event_probe_attr { uint64_t addr; @@ -229,7 +229,7 @@ struct lttng_event_probe_attr { * * The structures should be initialized to zero before use. */ -#define LTTNG_EVENT_FUNCTION_PADDING1 16 +#define LTTNG_EVENT_FUNCTION_PADDING1 16 struct lttng_event_function_attr { char symbol_name[LTTNG_SYMBOL_NAME_LEN]; @@ -241,8 +241,8 @@ struct lttng_event_function_attr { * * The structures should be initialized to zero before use. */ -#define LTTNG_EVENT_PADDING1 12 -#define LTTNG_EVENT_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32 +#define LTTNG_EVENT_PADDING1 12 +#define LTTNG_EVENT_PADDING2 LTTNG_SYMBOL_NAME_LEN + 32 struct lttng_event { /* Offset 0 */ enum lttng_event_type type; @@ -257,13 +257,13 @@ struct lttng_event { int loglevel; /* Offset 268 */ - int32_t enabled; /* Does not apply: -1 */ + int32_t enabled; /* Does not apply: -1 */ /* Offset 272 */ pid_t pid; /* Offset 276 */ - unsigned char filter; /* filter enabled ? */ + unsigned char filter; /* filter enabled ? */ /* Offset 277 */ unsigned char exclusion; /* exclusions added ? */ @@ -294,7 +294,7 @@ struct lttng_event { } attr; }; -#define LTTNG_EVENT_FIELD_PADDING LTTNG_SYMBOL_NAME_LEN + 32 +#define LTTNG_EVENT_FIELD_PADDING LTTNG_SYMBOL_NAME_LEN + 32 struct lttng_event_field { char field_name[LTTNG_SYMBOL_NAME_LEN]; enum lttng_event_field_type type; @@ -312,7 +312,8 @@ struct lttng_event_field { * free events. On error a negative LTTng error code is returned. */ LTTNG_EXPORT extern int lttng_list_events(struct lttng_handle *handle, - const char *channel_name, struct lttng_event **events); + const char *channel_name, + struct lttng_event **events); /* * Create an lttng_event. @@ -337,7 +338,7 @@ LTTNG_EXPORT extern struct lttng_event *lttng_event_create(void); * * This destruction function, introduced in LTTng 2.11, should only * be used with events created by lttng_event_create(). - */ + */ LTTNG_EXPORT extern void lttng_event_destroy(struct lttng_event *event); /* @@ -351,7 +352,7 @@ LTTNG_EXPORT extern void lttng_event_destroy(struct lttng_event *event); * Returns 0 on success, or a negative LTTng error code on error. */ LTTNG_EXPORT extern int lttng_event_get_filter_expression(struct lttng_event *event, - const char **filter_string); + const char **filter_string); /* * Get the number of exclusion names of a specific LTTng event. @@ -370,7 +371,8 @@ LTTNG_EXPORT extern int lttng_event_get_exclusion_name_count(struct lttng_event * Returns 0 on success, or a negative LTTng error code on error. */ LTTNG_EXPORT extern int lttng_event_get_exclusion_name(struct lttng_event *event, - size_t index, const char **exclusion_name); + size_t index, + const char **exclusion_name); /* * Get the userspace probe location of a specific LTTng event. @@ -392,8 +394,9 @@ lttng_event_get_userspace_probe_location(const struct lttng_event *event); * * Returns 0 on success, or a negative LTTng error code on error. */ -LTTNG_EXPORT extern int lttng_event_set_userspace_probe_location(struct lttng_event *event, - struct lttng_userspace_probe_location *probe_location); +LTTNG_EXPORT extern int +lttng_event_set_userspace_probe_location(struct lttng_event *event, + struct lttng_userspace_probe_location *probe_location); /* * List the available tracepoints of a specific lttng domain. @@ -404,7 +407,7 @@ LTTNG_EXPORT extern int lttng_event_set_userspace_probe_location(struct lttng_ev * free events. On error a negative LTTng error code is returned. */ LTTNG_EXPORT extern int lttng_list_tracepoints(struct lttng_handle *handle, - struct lttng_event **events); + struct lttng_event **events); /* * List the available tracepoints fields of a specific lttng domain. @@ -416,7 +419,7 @@ LTTNG_EXPORT extern int lttng_list_tracepoints(struct lttng_handle *handle, * returned. */ LTTNG_EXPORT extern int lttng_list_tracepoint_fields(struct lttng_handle *handle, - struct lttng_event_field **fields); + struct lttng_event_field **fields); /* * List the available kernel syscall. @@ -440,8 +443,9 @@ LTTNG_EXPORT extern int lttng_list_syscalls(struct lttng_event **events); * Return 0 on success else a negative LTTng error code. */ LTTNG_EXPORT extern int lttng_add_context(struct lttng_handle *handle, - struct lttng_event_context *ctx, const char *event_name, - const char *channel_name); + struct lttng_event_context *ctx, + const char *event_name, + const char *channel_name); /* * Create or enable an event (or events) for a channel. @@ -454,8 +458,8 @@ LTTNG_EXPORT extern int lttng_add_context(struct lttng_handle *handle, * * Return 0 on success else a negative LTTng error code. */ -LTTNG_EXPORT extern int lttng_enable_event(struct lttng_handle *handle, - struct lttng_event *ev, const char *channel_name); +LTTNG_EXPORT extern int +lttng_enable_event(struct lttng_handle *handle, struct lttng_event *ev, const char *channel_name); /* * Create or enable an event with a specific filter. @@ -471,8 +475,9 @@ LTTNG_EXPORT extern int lttng_enable_event(struct lttng_handle *handle, * Return 0 on success else a negative LTTng error code. */ LTTNG_EXPORT extern int lttng_enable_event_with_filter(struct lttng_handle *handle, - struct lttng_event *event, const char *channel_name, - const char *filter_expression); + struct lttng_event *event, + const char *channel_name, + const char *filter_expression); /* * Create or enable an event with a filter and/or exclusions. @@ -489,9 +494,11 @@ LTTNG_EXPORT extern int lttng_enable_event_with_filter(struct lttng_handle *hand * Return 0 on success else a negative LTTng error code. */ LTTNG_EXPORT extern int lttng_enable_event_with_exclusions(struct lttng_handle *handle, - struct lttng_event *event, const char *channel_name, - const char *filter_expression, - int exclusion_count, char **exclusion_names); + struct lttng_event *event, + const char *channel_name, + const char *filter_expression, + int exclusion_count, + char **exclusion_names); /* * Disable event(s) of a channel and domain. @@ -501,8 +508,8 @@ LTTNG_EXPORT extern int lttng_enable_event_with_exclusions(struct lttng_handle * * * Return 0 on success else a negative LTTng error code. */ -LTTNG_EXPORT extern int lttng_disable_event(struct lttng_handle *handle, - const char *name, const char *channel_name); +LTTNG_EXPORT extern int +lttng_disable_event(struct lttng_handle *handle, const char *name, const char *channel_name); /* * Disable event(s) of a channel and domain. @@ -518,8 +525,9 @@ LTTNG_EXPORT extern int lttng_disable_event(struct lttng_handle *handle, * Return 0 on success else a negative LTTng error code. */ LTTNG_EXPORT extern int lttng_disable_event_ext(struct lttng_handle *handle, - struct lttng_event *ev, const char *channel_name, - const char *filter_expression); + struct lttng_event *ev, + const char *channel_name, + const char *filter_expression); #ifdef __cplusplus }