1 #ifndef _LTTNG_EVENTS_H
2 #define _LTTNG_EVENTS_H
7 * Holds LTTng per-session event registry.
9 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
11 * This library is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public
13 * License as published by the Free Software Foundation; only
14 * version 2.1 of the License.
16 * This library is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with this library; if not, write to the Free Software
23 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
26 #include <linux/version.h>
27 #include <linux/list.h>
28 #include <linux/kprobes.h>
29 #include <linux/kref.h>
30 #include "wrapper/uuid.h"
31 #include "lttng-abi.h"
32 #include "lttng-abi-old.h"
34 #define lttng_is_signed_type(type) (((type)(-1)) < 0)
38 struct lttng_metadata_cache
;
39 struct lib_ring_buffer_ctx
;
41 struct perf_event_attr
;
42 struct lib_ring_buffer_config
;
44 /* Type description */
46 /* Update the astract_types name table in lttng-types.c along with this enum */
56 /* Update the string_encodings name table in lttng-types.c along with this enum */
57 enum lttng_string_encodings
{
58 lttng_encode_none
= 0,
59 lttng_encode_UTF8
= 1,
60 lttng_encode_ASCII
= 2,
69 struct lttng_enum_entry
{
70 unsigned long long start
, end
; /* start and end are inclusive */
74 #define __type_integer(_type, _byte_order, _base, _encoding) \
76 .atype = atype_integer, \
79 .size = sizeof(_type) * CHAR_BIT, \
80 .alignment = lttng_alignof(_type) * CHAR_BIT, \
81 .signedness = lttng_is_signed_type(_type), \
82 .reverse_byte_order = _byte_order != __BYTE_ORDER, \
84 .encoding = lttng_encode_##_encoding, \
88 struct lttng_integer_type {
89 unsigned int size
; /* in bits */
90 unsigned short alignment
; /* in bits */
91 unsigned int signedness
:1,
93 unsigned int base
; /* 2, 8, 10, 16, for pretty print */
94 enum lttng_string_encodings encoding
;
97 union _lttng_basic_type
{
98 struct lttng_integer_type integer
;
103 enum lttng_string_encodings encoding
;
107 struct lttng_basic_type
{
108 enum abstract_types atype
;
110 union _lttng_basic_type basic
;
115 enum abstract_types atype
;
117 union _lttng_basic_type basic
;
119 struct lttng_basic_type elem_type
;
120 unsigned int length
; /* num. elems. */
123 struct lttng_basic_type length_type
;
124 struct lttng_basic_type elem_type
;
131 struct lttng_type container_type
;
132 const struct lttng_enum_entry
*entries
;
136 /* Event field description */
138 struct lttng_event_field
{
140 struct lttng_type type
;
144 * We need to keep this perf counter field separately from struct
145 * lttng_ctx_field because cpu hotplug needs fixed-location addresses.
147 struct lttng_perf_counter_field
{
148 struct notifier_block nb
;
150 struct perf_event_attr
*attr
;
151 struct perf_event
**e
; /* per-cpu array */
154 struct lttng_ctx_field
{
155 struct lttng_event_field event_field
;
156 size_t (*get_size
)(size_t offset
);
157 void (*record
)(struct lttng_ctx_field
*field
,
158 struct lib_ring_buffer_ctx
*ctx
,
159 struct lttng_channel
*chan
);
161 struct lttng_perf_counter_field
*perf_counter
;
163 void (*destroy
)(struct lttng_ctx_field
*field
);
167 struct lttng_ctx_field
*fields
;
168 unsigned int nr_fields
;
169 unsigned int allocated_fields
;
170 size_t largest_align
; /* in bytes */
173 struct lttng_event_desc
{
174 const char *name
; /* lttng-modules name */
175 const char *kname
; /* Linux kernel name (tracepoints) */
176 void *probe_callback
;
177 const struct lttng_event_ctx
*ctx
; /* context */
178 const struct lttng_event_field
*fields
; /* event payload */
179 unsigned int nr_fields
;
180 struct module
*owner
;
183 struct lttng_probe_desc
{
184 const struct lttng_event_desc
**event_desc
;
185 unsigned int nr_events
;
186 struct list_head head
; /* chain registered probes */
189 struct lttng_krp
; /* Kretprobe handling */
192 * lttng_event structure is referred to by the tracing fast path. It must be
197 struct lttng_channel
*chan
;
199 const struct lttng_event_desc
*desc
;
201 struct lttng_ctx
*ctx
;
202 enum lttng_kernel_instrumentation instrumentation
;
209 struct lttng_krp
*lttng_krp
;
216 struct list_head list
; /* Event list */
217 unsigned int metadata_dumped
:1;
220 struct lttng_channel_ops
{
221 struct channel
*(*channel_create
)(const char *name
,
222 struct lttng_channel
*lttng_chan
,
224 size_t subbuf_size
, size_t num_subbuf
,
225 unsigned int switch_timer_interval
,
226 unsigned int read_timer_interval
);
227 void (*channel_destroy
)(struct channel
*chan
);
228 struct lib_ring_buffer
*(*buffer_read_open
)(struct channel
*chan
);
229 int (*buffer_has_read_closed_stream
)(struct channel
*chan
);
230 void (*buffer_read_close
)(struct lib_ring_buffer
*buf
);
231 int (*event_reserve
)(struct lib_ring_buffer_ctx
*ctx
,
233 void (*event_commit
)(struct lib_ring_buffer_ctx
*ctx
);
234 void (*event_write
)(struct lib_ring_buffer_ctx
*ctx
, const void *src
,
236 void (*event_write_from_user
)(struct lib_ring_buffer_ctx
*ctx
,
237 const void *src
, size_t len
);
238 void (*event_memset
)(struct lib_ring_buffer_ctx
*ctx
,
240 void (*event_strcpy
)(struct lib_ring_buffer_ctx
*ctx
, const char *src
,
242 void (*event_strcpy_from_user
)(struct lib_ring_buffer_ctx
*ctx
,
243 const char __user
*src
, size_t len
);
245 * packet_avail_size returns the available size in the current
246 * packet. Note that the size returned is only a hint, since it
247 * may change due to concurrent writes.
249 size_t (*packet_avail_size
)(struct channel
*chan
);
250 wait_queue_head_t
*(*get_writer_buf_wait_queue
)(struct channel
*chan
, int cpu
);
251 wait_queue_head_t
*(*get_hp_wait_queue
)(struct channel
*chan
);
252 int (*is_finalized
)(struct channel
*chan
);
253 int (*is_disabled
)(struct channel
*chan
);
254 int (*timestamp_begin
) (const struct lib_ring_buffer_config
*config
,
255 struct lib_ring_buffer
*bufb
,
256 uint64_t *timestamp_begin
);
257 int (*timestamp_end
) (const struct lib_ring_buffer_config
*config
,
258 struct lib_ring_buffer
*bufb
,
259 uint64_t *timestamp_end
);
260 int (*events_discarded
) (const struct lib_ring_buffer_config
*config
,
261 struct lib_ring_buffer
*bufb
,
262 uint64_t *events_discarded
);
263 int (*content_size
) (const struct lib_ring_buffer_config
*config
,
264 struct lib_ring_buffer
*bufb
,
265 uint64_t *content_size
);
266 int (*packet_size
) (const struct lib_ring_buffer_config
*config
,
267 struct lib_ring_buffer
*bufb
,
268 uint64_t *packet_size
);
269 int (*stream_id
) (const struct lib_ring_buffer_config
*config
,
270 struct lib_ring_buffer
*bufb
,
271 uint64_t *stream_id
);
272 int (*current_timestamp
) (const struct lib_ring_buffer_config
*config
,
273 struct lib_ring_buffer
*bufb
,
277 struct lttng_transport
{
279 struct module
*owner
;
280 struct list_head node
;
281 struct lttng_channel_ops ops
;
284 struct lttng_syscall_filter
;
286 struct lttng_channel
{
288 struct channel
*chan
; /* Channel buffers */
290 struct lttng_ctx
*ctx
;
291 /* Event ID management */
292 struct lttng_session
*session
;
293 struct file
*file
; /* File associated to channel */
294 unsigned int free_event_id
; /* Next event ID to allocate */
295 struct list_head list
; /* Channel list */
296 struct lttng_channel_ops
*ops
;
297 struct lttng_transport
*transport
;
298 struct lttng_event
**sc_table
; /* for syscall tracing */
299 struct lttng_event
**compat_sc_table
;
300 struct lttng_event
**sc_exit_table
; /* for syscall exit tracing */
301 struct lttng_event
**compat_sc_exit_table
;
302 struct lttng_event
*sc_unknown
; /* for unknown syscalls */
303 struct lttng_event
*sc_compat_unknown
;
304 struct lttng_event
*sc_exit_unknown
;
305 struct lttng_event
*compat_sc_exit_unknown
;
306 struct lttng_syscall_filter
*sc_filter
;
307 int header_type
; /* 0: unset, 1: compact, 2: large */
308 enum channel_type channel_type
;
309 unsigned int metadata_dumped
:1,
310 sys_enter_registered
:1,
311 sys_exit_registered
:1,
315 struct lttng_metadata_stream
{
316 void *priv
; /* Ring buffer private data */
317 struct lttng_metadata_cache
*metadata_cache
;
318 unsigned int metadata_in
; /* Bytes read from the cache */
319 unsigned int metadata_out
; /* Bytes consumed from stream */
320 int finalized
; /* Has channel been finalized */
321 wait_queue_head_t read_wait
; /* Reader buffer-level wait queue */
322 struct list_head list
; /* Stream list */
323 struct lttng_transport
*transport
;
329 * struct lttng_pid_tracker declared in header due to deferencing of *v
330 * in RCU_INITIALIZER(v).
332 #define LTTNG_PID_HASH_BITS 6
333 #define LTTNG_PID_TABLE_SIZE (1 << LTTNG_PID_HASH_BITS)
335 struct lttng_pid_tracker
{
336 struct hlist_head pid_hash
[LTTNG_PID_TABLE_SIZE
];
339 struct lttng_pid_hash_node
{
340 struct hlist_node hlist
;
344 struct lttng_session
{
345 int active
; /* Is trace session active ? */
346 int been_active
; /* Has trace session been active ? */
347 struct file
*file
; /* File associated to session */
348 struct list_head chan
; /* Channel list head */
349 struct list_head events
; /* Event list head */
350 struct list_head list
; /* Session list */
351 unsigned int free_chan_id
; /* Next chan ID to allocate */
352 uuid_le uuid
; /* Trace session unique ID */
353 struct lttng_metadata_cache
*metadata_cache
;
354 struct lttng_pid_tracker
*pid_tracker
;
355 unsigned int metadata_dumped
:1;
358 struct lttng_metadata_cache
{
359 char *data
; /* Metadata cache */
360 unsigned int cache_alloc
; /* Metadata allocated size (bytes) */
361 unsigned int metadata_written
; /* Number of bytes written in metadata cache */
362 struct kref refcount
; /* Metadata cache usage */
363 struct list_head metadata_stream
; /* Metadata stream list */
364 uuid_le uuid
; /* Trace session unique ID (copy) */
367 struct lttng_session
*lttng_session_create(void);
368 int lttng_session_enable(struct lttng_session
*session
);
369 int lttng_session_disable(struct lttng_session
*session
);
370 void lttng_session_destroy(struct lttng_session
*session
);
371 void metadata_cache_destroy(struct kref
*kref
);
373 struct lttng_channel
*lttng_channel_create(struct lttng_session
*session
,
374 const char *transport_name
,
376 size_t subbuf_size
, size_t num_subbuf
,
377 unsigned int switch_timer_interval
,
378 unsigned int read_timer_interval
,
379 enum channel_type channel_type
);
380 struct lttng_channel
*lttng_global_channel_create(struct lttng_session
*session
,
381 int overwrite
, void *buf_addr
,
382 size_t subbuf_size
, size_t num_subbuf
,
383 unsigned int switch_timer_interval
,
384 unsigned int read_timer_interval
);
386 void lttng_metadata_channel_destroy(struct lttng_channel
*chan
);
387 struct lttng_event
*lttng_event_create(struct lttng_channel
*chan
,
388 struct lttng_kernel_event
*event_param
,
390 const struct lttng_event_desc
*internal_desc
);
391 struct lttng_event
*lttng_event_compat_old_create(struct lttng_channel
*chan
,
392 struct lttng_kernel_old_event
*old_event_param
,
394 const struct lttng_event_desc
*internal_desc
);
396 int lttng_channel_enable(struct lttng_channel
*channel
);
397 int lttng_channel_disable(struct lttng_channel
*channel
);
398 int lttng_event_enable(struct lttng_event
*event
);
399 int lttng_event_disable(struct lttng_event
*event
);
401 void lttng_transport_register(struct lttng_transport
*transport
);
402 void lttng_transport_unregister(struct lttng_transport
*transport
);
404 void synchronize_trace(void);
405 int lttng_abi_init(void);
406 int lttng_abi_compat_old_init(void);
407 void lttng_abi_exit(void);
408 void lttng_abi_compat_old_exit(void);
410 int lttng_probe_register(struct lttng_probe_desc
*desc
);
411 void lttng_probe_unregister(struct lttng_probe_desc
*desc
);
412 const struct lttng_event_desc
*lttng_event_get(const char *name
);
413 void lttng_event_put(const struct lttng_event_desc
*desc
);
414 int lttng_probes_init(void);
415 void lttng_probes_exit(void);
417 int lttng_metadata_output_channel(struct lttng_metadata_stream
*stream
,
418 struct channel
*chan
);
420 int lttng_pid_tracker_get_node_pid(const struct lttng_pid_hash_node
*node
);
421 struct lttng_pid_tracker
*lttng_pid_tracker_create(void);
422 void lttng_pid_tracker_destroy(struct lttng_pid_tracker
*lpf
);
423 bool lttng_pid_tracker_lookup(struct lttng_pid_tracker
*lpf
, int pid
);
424 int lttng_pid_tracker_add(struct lttng_pid_tracker
*lpf
, int pid
);
425 int lttng_pid_tracker_del(struct lttng_pid_tracker
*lpf
, int pid
);
427 int lttng_session_track_pid(struct lttng_session
*session
, int pid
);
428 int lttng_session_untrack_pid(struct lttng_session
*session
, int pid
);
430 int lttng_session_list_tracker_pids(struct lttng_session
*session
);
432 #if defined(CONFIG_HAVE_SYSCALL_TRACEPOINTS)
433 int lttng_syscalls_register(struct lttng_channel
*chan
, void *filter
);
434 int lttng_syscalls_unregister(struct lttng_channel
*chan
);
435 int lttng_syscall_filter_enable(struct lttng_channel
*chan
,
437 int lttng_syscall_filter_disable(struct lttng_channel
*chan
,
439 long lttng_channel_syscall_mask(struct lttng_channel
*channel
,
440 struct lttng_kernel_syscall_mask __user
*usyscall_mask
);
441 int lttng_abi_syscall_list(void);
443 static inline int lttng_syscalls_register(struct lttng_channel
*chan
, void *filter
)
448 static inline int lttng_syscalls_unregister(struct lttng_channel
*chan
)
454 int lttng_syscall_filter_enable(struct lttng_channel
*chan
,
461 int lttng_syscall_filter_disable(struct lttng_channel
*chan
,
468 long lttng_channel_syscall_mask(struct lttng_channel
*channel
,
469 struct lttng_kernel_syscall_mask __user
*usyscall_mask
)
475 int lttng_abi_syscall_list(void)
481 struct lttng_ctx_field
*lttng_append_context(struct lttng_ctx
**ctx
);
482 void lttng_context_update(struct lttng_ctx
*ctx
);
483 int lttng_find_context(struct lttng_ctx
*ctx
, const char *name
);
484 void lttng_remove_context_field(struct lttng_ctx
**ctx
,
485 struct lttng_ctx_field
*field
);
486 void lttng_destroy_context(struct lttng_ctx
*ctx
);
487 int lttng_add_pid_to_ctx(struct lttng_ctx
**ctx
);
488 int lttng_add_procname_to_ctx(struct lttng_ctx
**ctx
);
489 int lttng_add_prio_to_ctx(struct lttng_ctx
**ctx
);
490 int lttng_add_nice_to_ctx(struct lttng_ctx
**ctx
);
491 int lttng_add_vpid_to_ctx(struct lttng_ctx
**ctx
);
492 int lttng_add_tid_to_ctx(struct lttng_ctx
**ctx
);
493 int lttng_add_vtid_to_ctx(struct lttng_ctx
**ctx
);
494 int lttng_add_ppid_to_ctx(struct lttng_ctx
**ctx
);
495 int lttng_add_vppid_to_ctx(struct lttng_ctx
**ctx
);
496 int lttng_add_hostname_to_ctx(struct lttng_ctx
**ctx
);
497 #if defined(CONFIG_PERF_EVENTS) && (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,33))
498 int lttng_add_perf_counter_to_ctx(uint32_t type
,
501 struct lttng_ctx
**ctx
);
504 int lttng_add_perf_counter_to_ctx(uint32_t type
,
507 struct lttng_ctx
**ctx
)
513 int lttng_logger_init(void);
514 void lttng_logger_exit(void);
516 extern int lttng_statedump_start(struct lttng_session
*session
);
518 #ifdef CONFIG_KPROBES
519 int lttng_kprobes_register(const char *name
,
520 const char *symbol_name
,
523 struct lttng_event
*event
);
524 void lttng_kprobes_unregister(struct lttng_event
*event
);
525 void lttng_kprobes_destroy_private(struct lttng_event
*event
);
528 int lttng_kprobes_register(const char *name
,
529 const char *symbol_name
,
532 struct lttng_event
*event
)
538 void lttng_kprobes_unregister(struct lttng_event
*event
)
543 void lttng_kprobes_destroy_private(struct lttng_event
*event
)
548 #ifdef CONFIG_KRETPROBES
549 int lttng_kretprobes_register(const char *name
,
550 const char *symbol_name
,
553 struct lttng_event
*event_entry
,
554 struct lttng_event
*event_exit
);
555 void lttng_kretprobes_unregister(struct lttng_event
*event
);
556 void lttng_kretprobes_destroy_private(struct lttng_event
*event
);
559 int lttng_kretprobes_register(const char *name
,
560 const char *symbol_name
,
563 struct lttng_event
*event_entry
,
564 struct lttng_event
*event_exit
)
570 void lttng_kretprobes_unregister(struct lttng_event
*event
)
575 void lttng_kretprobes_destroy_private(struct lttng_event
*event
)
580 #ifdef CONFIG_DYNAMIC_FTRACE
581 int lttng_ftrace_register(const char *name
,
582 const char *symbol_name
,
583 struct lttng_event
*event
);
584 void lttng_ftrace_unregister(struct lttng_event
*event
);
585 void lttng_ftrace_destroy_private(struct lttng_event
*event
);
588 int lttng_ftrace_register(const char *name
,
589 const char *symbol_name
,
590 struct lttng_event
*event
)
596 void lttng_ftrace_unregister(struct lttng_event
*event
)
601 void lttng_ftrace_destroy_private(struct lttng_event
*event
)
606 int lttng_calibrate(struct lttng_kernel_calibrate
*calibrate
);
608 extern const struct file_operations lttng_tracepoint_list_fops
;
609 extern const struct file_operations lttng_syscall_list_fops
;
611 #if (LINUX_VERSION_CODE >= KERNEL_VERSION(2,6,35))
612 #define TRACEPOINT_HAS_DATA_ARG
615 #endif /* _LTTNG_EVENTS_H */