2 * Copyright (C) 2011 Julien Desfossez <julien.desfossez@polymtl.ca>
3 * Copyright (C) 2011 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
4 * Copyright (C) 2016 Jérémie Galarneau <jeremie.galarneau@efficios.com>
6 * SPDX-License-Identifier: GPL-2.0-only
10 #include "lttng/tracker.h"
12 #define __USE_LINUX_IOCTL_DEFS
13 #include <sys/ioctl.h>
15 #include <common/align.h>
16 #include <common/macros.h>
17 #include <common/compat/errno.h>
20 #include <common/time.h>
22 #include "kernel-ctl.h"
23 #include "kernel-ioctl.h"
25 #define LTTNG_IOCTL_CHECK(fildes, request, ...) ({ \
26 int ret = ioctl(fildes, request, ##__VA_ARGS__);\
31 #define LTTNG_IOCTL_NO_CHECK(fildes, request, ...) ({ \
32 int ret = ioctl(fildes, request, ##__VA_ARGS__);\
33 ret >= 0 ? ret : -errno; \
37 * This flag indicates which version of the kernel ABI to use. The old
38 * ABI (namespace _old) does not support a 32-bit user-space when the
39 * kernel is 64-bit. The old ABI is kept here for compatibility but is
40 * deprecated and will be removed eventually.
42 static int lttng_kernel_use_old_abi
= -1;
45 * Execute the new or old ioctl depending on the ABI version.
46 * If the ABI version is not determined yet (lttng_kernel_use_old_abi = -1),
47 * this function tests if the new ABI is available and otherwise fallbacks
49 * This function takes the fd on which the ioctl must be executed and the old
50 * and new request codes.
51 * It returns the return value of the ioctl executed.
53 static inline int compat_ioctl_no_arg(int fd
, unsigned long oldname
,
54 unsigned long newname
)
58 if (lttng_kernel_use_old_abi
== -1) {
59 ret
= LTTNG_IOCTL_NO_CHECK(fd
, newname
);
61 lttng_kernel_use_old_abi
= 0;
64 lttng_kernel_use_old_abi
= 1;
66 if (lttng_kernel_use_old_abi
) {
67 ret
= LTTNG_IOCTL_NO_CHECK(fd
, oldname
);
69 ret
= LTTNG_IOCTL_NO_CHECK(fd
, newname
);
76 int kernctl_create_session(int fd
)
78 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_SESSION
,
79 LTTNG_KERNEL_SESSION
);
82 /* open the metadata global channel */
83 int kernctl_open_metadata(int fd
, struct lttng_channel_attr
*chops
)
85 struct lttng_kernel_channel channel
;
87 if (lttng_kernel_use_old_abi
) {
88 struct lttng_kernel_old_channel old_channel
;
90 memset(&old_channel
, 0, sizeof(old_channel
));
91 old_channel
.overwrite
= chops
->overwrite
;
92 old_channel
.subbuf_size
= chops
->subbuf_size
;
93 old_channel
.num_subbuf
= chops
->num_subbuf
;
94 old_channel
.switch_timer_interval
= chops
->switch_timer_interval
;
95 old_channel
.read_timer_interval
= chops
->read_timer_interval
;
96 old_channel
.output
= chops
->output
;
98 memset(old_channel
.padding
, 0, sizeof(old_channel
.padding
));
100 * The new channel padding is smaller than the old ABI so we use the
101 * new ABI padding size for the memcpy.
103 memcpy(old_channel
.padding
, chops
->padding
, sizeof(chops
->padding
));
105 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_OLD_METADATA
,
109 memset(&channel
, 0, sizeof(channel
));
110 channel
.overwrite
= chops
->overwrite
;
111 channel
.subbuf_size
= chops
->subbuf_size
;
112 channel
.num_subbuf
= chops
->num_subbuf
;
113 channel
.switch_timer_interval
= chops
->switch_timer_interval
;
114 channel
.read_timer_interval
= chops
->read_timer_interval
;
115 channel
.output
= chops
->output
;
116 memcpy(channel
.padding
, chops
->padding
, sizeof(chops
->padding
));
118 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_METADATA
, &channel
);
121 int kernctl_create_channel(int fd
, struct lttng_channel_attr
*chops
)
123 struct lttng_kernel_channel channel
;
125 memset(&channel
, 0, sizeof(channel
));
126 if (lttng_kernel_use_old_abi
) {
127 struct lttng_kernel_old_channel old_channel
;
129 old_channel
.overwrite
= chops
->overwrite
;
130 old_channel
.subbuf_size
= chops
->subbuf_size
;
131 old_channel
.num_subbuf
= chops
->num_subbuf
;
132 old_channel
.switch_timer_interval
= chops
->switch_timer_interval
;
133 old_channel
.read_timer_interval
= chops
->read_timer_interval
;
134 old_channel
.output
= chops
->output
;
136 memset(old_channel
.padding
, 0, sizeof(old_channel
.padding
));
138 * The new channel padding is smaller than the old ABI so we use the
139 * new ABI padding size for the memcpy.
141 memcpy(old_channel
.padding
, chops
->padding
, sizeof(chops
->padding
));
143 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_OLD_CHANNEL
,
147 channel
.overwrite
= chops
->overwrite
;
148 channel
.subbuf_size
= chops
->subbuf_size
;
149 channel
.num_subbuf
= chops
->num_subbuf
;
150 channel
.switch_timer_interval
= chops
->switch_timer_interval
;
151 channel
.read_timer_interval
= chops
->read_timer_interval
;
152 channel
.output
= chops
->output
;
153 memcpy(channel
.padding
, chops
->padding
, sizeof(chops
->padding
));
155 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_CHANNEL
, &channel
);
158 int kernctl_create_session_counter(int session_fd
, struct lttng_kernel_counter_conf
*counter_conf
)
160 return LTTNG_IOCTL_NO_CHECK(session_fd
, LTTNG_KERNEL_COUNTER
, counter_conf
);
164 int kernctl_syscall_mask(int fd
, char **syscall_mask
, uint32_t *nr_bits
)
166 struct lttng_kernel_syscall_mask kmask_len
, *kmask
= NULL
;
167 size_t array_alloc_len
;
182 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SYSCALL_MASK
, &kmask_len
);
187 array_alloc_len
= ALIGN(kmask_len
.len
, 8) >> 3;
189 kmask
= zmalloc(sizeof(*kmask
) + array_alloc_len
);
195 kmask
->len
= kmask_len
.len
;
196 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SYSCALL_MASK
, kmask
);
201 new_mask
= realloc(*syscall_mask
, array_alloc_len
);
206 memcpy(new_mask
, kmask
->mask
, array_alloc_len
);
207 *syscall_mask
= new_mask
;
208 *nr_bits
= kmask
->len
;
215 int kernctl_track_pid(int fd
, int pid
)
217 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_TRACK_PID
, pid
);
220 int kernctl_untrack_pid(int fd
, int pid
)
222 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_UNTRACK_PID
, pid
);
225 int kernctl_list_tracker_pids(int fd
)
227 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_SESSION_LIST_TRACKER_PIDS
);
230 static enum lttng_kernel_tracker_type
get_kernel_tracker_type(
231 enum lttng_process_attr process_attr
)
233 switch (process_attr
) {
234 case LTTNG_PROCESS_ATTR_PROCESS_ID
:
235 return LTTNG_KERNEL_TRACKER_PID
;
236 case LTTNG_PROCESS_ATTR_VIRTUAL_PROCESS_ID
:
237 return LTTNG_KERNEL_TRACKER_VPID
;
238 case LTTNG_PROCESS_ATTR_USER_ID
:
239 return LTTNG_KERNEL_TRACKER_UID
;
240 case LTTNG_PROCESS_ATTR_VIRTUAL_USER_ID
:
241 return LTTNG_KERNEL_TRACKER_VUID
;
242 case LTTNG_PROCESS_ATTR_GROUP_ID
:
243 return LTTNG_KERNEL_TRACKER_GID
;
244 case LTTNG_PROCESS_ATTR_VIRTUAL_GROUP_ID
:
245 return LTTNG_KERNEL_TRACKER_VGID
;
247 return LTTNG_KERNEL_TRACKER_UNKNOWN
;
251 int kernctl_track_id(int fd
, enum lttng_process_attr process_attr
, int id
)
253 struct lttng_kernel_tracker_args args
;
256 args
.type
= get_kernel_tracker_type(process_attr
);
257 if (args
.type
== LTTNG_KERNEL_TRACKER_UNKNOWN
) {
261 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_TRACK_ID
, &args
);
264 int kernctl_untrack_id(int fd
, enum lttng_process_attr process_attr
, int id
)
266 struct lttng_kernel_tracker_args args
;
269 args
.type
= get_kernel_tracker_type(process_attr
);
270 if (args
.type
== LTTNG_KERNEL_TRACKER_UNKNOWN
) {
274 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_UNTRACK_ID
, &args
);
277 int kernctl_list_tracker_ids(int fd
, enum lttng_process_attr process_attr
)
279 struct lttng_kernel_tracker_args args
;
282 args
.type
= get_kernel_tracker_type(process_attr
);
283 if (args
.type
== LTTNG_KERNEL_TRACKER_UNKNOWN
) {
287 return LTTNG_IOCTL_NO_CHECK(
288 fd
, LTTNG_KERNEL_SESSION_LIST_TRACKER_IDS
, &args
);
291 int kernctl_session_regenerate_metadata(int fd
)
293 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_METADATA_REGEN
);
296 int kernctl_session_regenerate_statedump(int fd
)
298 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_STATEDUMP
);
301 int kernctl_session_set_name(int fd
, const char *name
)
304 struct lttng_kernel_session_name session_name
;
306 ret
= lttng_strncpy(session_name
.name
, name
, sizeof(session_name
.name
));
311 ret
= LTTNG_IOCTL_CHECK(
312 fd
, LTTNG_KERNEL_SESSION_SET_NAME
, &session_name
);
317 int kernctl_session_set_creation_time(int fd
, time_t time
)
320 struct lttng_kernel_session_creation_time creation_time
;
322 ret
= time_to_iso8601_str(time
, creation_time
.iso8601
,
323 sizeof(creation_time
.iso8601
));
328 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_SESSION_SET_CREATION_TIME
,
334 int kernctl_create_stream(int fd
)
336 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_STREAM
,
337 LTTNG_KERNEL_STREAM
);
340 int kernctl_create_event(int fd
, struct lttng_kernel_event
*ev
)
342 if (lttng_kernel_use_old_abi
) {
343 struct lttng_kernel_old_event old_event
;
345 memset(&old_event
, 0, sizeof(old_event
));
346 memcpy(old_event
.name
, ev
->name
, sizeof(old_event
.name
));
347 old_event
.instrumentation
= ev
->instrumentation
;
348 switch (ev
->instrumentation
) {
349 case LTTNG_KERNEL_KPROBE
:
350 old_event
.u
.kprobe
.addr
= ev
->u
.kprobe
.addr
;
351 old_event
.u
.kprobe
.offset
= ev
->u
.kprobe
.offset
;
352 memcpy(old_event
.u
.kprobe
.symbol_name
,
353 ev
->u
.kprobe
.symbol_name
,
354 sizeof(old_event
.u
.kprobe
.symbol_name
));
356 case LTTNG_KERNEL_KRETPROBE
:
357 old_event
.u
.kretprobe
.addr
= ev
->u
.kretprobe
.addr
;
358 old_event
.u
.kretprobe
.offset
= ev
->u
.kretprobe
.offset
;
359 memcpy(old_event
.u
.kretprobe
.symbol_name
,
360 ev
->u
.kretprobe
.symbol_name
,
361 sizeof(old_event
.u
.kretprobe
.symbol_name
));
363 case LTTNG_KERNEL_FUNCTION
:
364 memcpy(old_event
.u
.ftrace
.symbol_name
,
365 ev
->u
.ftrace
.symbol_name
,
366 sizeof(old_event
.u
.ftrace
.symbol_name
));
372 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_OLD_EVENT
,
375 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_EVENT
, ev
);
378 int kernctl_add_context(int fd
, struct lttng_kernel_context
*ctx
)
380 if (lttng_kernel_use_old_abi
) {
381 struct lttng_kernel_old_context old_ctx
;
383 memset(&old_ctx
, 0, sizeof(old_ctx
));
384 old_ctx
.ctx
= ctx
->ctx
;
385 /* only type that uses the union */
386 if (ctx
->ctx
== LTTNG_KERNEL_CONTEXT_PERF_CPU_COUNTER
) {
387 old_ctx
.u
.perf_counter
.type
=
388 ctx
->u
.perf_counter
.type
;
389 old_ctx
.u
.perf_counter
.config
=
390 ctx
->u
.perf_counter
.config
;
391 memcpy(old_ctx
.u
.perf_counter
.name
,
392 ctx
->u
.perf_counter
.name
,
393 sizeof(old_ctx
.u
.perf_counter
.name
));
395 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_OLD_CONTEXT
, &old_ctx
);
397 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_CONTEXT
, ctx
);
401 /* Enable event, channel and session LTTNG_IOCTL_CHECK */
402 int kernctl_enable(int fd
)
404 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_ENABLE
,
405 LTTNG_KERNEL_ENABLE
);
408 /* Disable event, channel and session LTTNG_IOCTL_CHECK */
409 int kernctl_disable(int fd
)
411 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_DISABLE
,
412 LTTNG_KERNEL_DISABLE
);
415 int kernctl_start_session(int fd
)
417 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_SESSION_START
,
418 LTTNG_KERNEL_SESSION_START
);
421 int kernctl_stop_session(int fd
)
423 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_SESSION_STOP
,
424 LTTNG_KERNEL_SESSION_STOP
);
427 int kernctl_create_event_notifier_group(int fd
)
429 return LTTNG_IOCTL_NO_CHECK(fd
,
430 LTTNG_KERNEL_EVENT_NOTIFIER_GROUP_CREATE
);
433 int kernctl_create_counter_event(int fd
, struct lttng_kernel_counter_event
*ev
)
435 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_COUNTER_EVENT
, ev
);
438 int kernctl_create_event_notifier_group_notification_fd(int group_fd
)
440 return LTTNG_IOCTL_NO_CHECK(group_fd
,
441 LTTNG_KERNEL_EVENT_NOTIFIER_GROUP_NOTIFICATION_FD
);
444 int kernctl_create_event_notifier_group_error_counter(int group_fd
,
445 struct lttng_kernel_counter_conf
*error_counter_conf
)
447 return LTTNG_IOCTL_NO_CHECK(group_fd
, LTTNG_KERNEL_COUNTER
,
451 int kernctl_counter_read_value(int counter_fd
,
452 struct lttng_kernel_counter_read
*value
)
454 return LTTNG_IOCTL_NO_CHECK(counter_fd
, LTTNG_KERNEL_COUNTER_READ
,
458 int kernctl_counter_get_aggregate_value(int counter_fd
,
459 struct lttng_kernel_counter_aggregate
*value
)
461 return LTTNG_IOCTL_NO_CHECK(counter_fd
, LTTNG_KERNEL_COUNTER_AGGREGATE
,
465 int kernctl_counter_clear(int counter_fd
,
466 struct lttng_kernel_counter_clear
*clear
)
468 return LTTNG_IOCTL_NO_CHECK(counter_fd
, LTTNG_KERNEL_COUNTER_CLEAR
,
472 int kernctl_counter_map_descriptor_count(int counter_fd
, uint64_t *count
)
474 struct lttng_kernel_counter_map_nr_descriptors nr_desc
;
477 ret
= LTTNG_IOCTL_NO_CHECK(counter_fd
,
478 LTTNG_KERNEL_COUNTER_MAP_NR_DESCRIPTORS
, &nr_desc
);
479 *count
= nr_desc
.nr_descriptors
;
484 int kernctl_counter_map_descriptor(int counter_fd
,
485 struct lttng_kernel_counter_map_descriptor
*descriptor
)
487 return LTTNG_IOCTL_NO_CHECK(counter_fd
,
488 LTTNG_KERNEL_COUNTER_MAP_DESCRIPTOR
, descriptor
);
491 int kernctl_create_event_notifier(int group_fd
,
492 const struct lttng_kernel_event_notifier
*event_notifier
)
494 return LTTNG_IOCTL_NO_CHECK(group_fd
,
495 LTTNG_KERNEL_EVENT_NOTIFIER_CREATE
, event_notifier
);
498 int kernctl_capture(int fd
, const struct lttng_bytecode
*capture
)
500 struct lttng_kernel_capture_bytecode
*kb
;
504 /* Translate bytecode to kernel bytecode */
505 kb
= zmalloc(sizeof(*kb
) + capture
->len
);
508 kb
->len
= len
= capture
->len
;
509 kb
->reloc_offset
= capture
->reloc_table_offset
;
510 kb
->seqnum
= capture
->seqnum
;
511 memcpy(kb
->data
, capture
->data
, len
);
512 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_CAPTURE
, kb
);
517 int kernctl_filter(int fd
, const struct lttng_bytecode
*filter
)
519 struct lttng_kernel_filter_bytecode
*kb
;
523 /* Translate bytecode to kernel bytecode */
524 kb
= zmalloc(sizeof(*kb
) + filter
->len
);
527 kb
->len
= len
= filter
->len
;
528 kb
->reloc_offset
= filter
->reloc_table_offset
;
529 kb
->seqnum
= filter
->seqnum
;
530 memcpy(kb
->data
, filter
->data
, len
);
531 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_FILTER
, kb
);
536 int kernctl_add_callsite(int fd
, struct lttng_kernel_event_callsite
*callsite
)
538 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_ADD_CALLSITE
, callsite
);
541 int kernctl_tracepoint_list(int fd
)
543 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_TRACEPOINT_LIST
,
544 LTTNG_KERNEL_TRACEPOINT_LIST
);
547 int kernctl_syscall_list(int fd
)
549 return LTTNG_IOCTL_NO_CHECK(fd
, LTTNG_KERNEL_SYSCALL_LIST
);
552 int kernctl_tracer_version(int fd
, struct lttng_kernel_tracer_version
*v
)
556 if (lttng_kernel_use_old_abi
== -1) {
557 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_TRACER_VERSION
, v
);
559 lttng_kernel_use_old_abi
= 0;
562 lttng_kernel_use_old_abi
= 1;
564 if (lttng_kernel_use_old_abi
) {
565 struct lttng_kernel_old_tracer_version old_v
;
567 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_OLD_TRACER_VERSION
, &old_v
);
571 v
->major
= old_v
.major
;
572 v
->minor
= old_v
.minor
;
573 v
->patchlevel
= old_v
.patchlevel
;
575 ret
= LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_TRACER_VERSION
, v
);
582 int kernctl_tracer_abi_version(int fd
,
583 struct lttng_kernel_tracer_abi_version
*v
)
585 return LTTNG_IOCTL_CHECK(fd
, LTTNG_KERNEL_TRACER_ABI_VERSION
, v
);
588 int kernctl_wait_quiescent(int fd
)
590 return compat_ioctl_no_arg(fd
, LTTNG_KERNEL_OLD_WAIT_QUIESCENT
,
591 LTTNG_KERNEL_WAIT_QUIESCENT
);
594 int kernctl_buffer_flush(int fd
)
596 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_FLUSH
);
599 int kernctl_buffer_flush_empty(int fd
)
601 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_FLUSH_EMPTY
);
604 int kernctl_buffer_clear(int fd
)
606 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_CLEAR
);
609 int kernctl_get_next_subbuf_metadata_check(int fd
, bool *consistent
)
611 return LTTNG_IOCTL_NO_CHECK(fd
,
612 RING_RING_BUFFER_GET_NEXT_SUBBUF_METADATA_CHECK
,
616 /* returns the version of the metadata. */
617 int kernctl_get_metadata_version(int fd
, uint64_t *version
)
619 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_METADATA_VERSION
, version
);
622 int kernctl_metadata_cache_dump(int fd
)
624 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_METADATA_CACHE_DUMP
);
627 /* Buffer operations */
629 /* For mmap mode, readable without "get" operation */
631 /* returns the length to mmap. */
632 int kernctl_get_mmap_len(int fd
, unsigned long *len
)
634 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_MMAP_LEN
, len
);
637 /* returns the maximum size for sub-buffers. */
638 int kernctl_get_max_subbuf_size(int fd
, unsigned long *len
)
640 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_MAX_SUBBUF_SIZE
, len
);
644 * For mmap mode, operate on the current packet (between get/put or
645 * get_next/put_next).
648 /* returns the offset of the subbuffer belonging to the mmap reader. */
649 int kernctl_get_mmap_read_offset(int fd
, unsigned long *off
)
651 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_MMAP_READ_OFFSET
, off
);
654 /* returns the size of the current sub-buffer, without padding (for mmap). */
655 int kernctl_get_subbuf_size(int fd
, unsigned long *len
)
657 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_SUBBUF_SIZE
, len
);
660 /* returns the size of the current sub-buffer, without padding (for mmap). */
661 int kernctl_get_padded_subbuf_size(int fd
, unsigned long *len
)
663 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_PADDED_SUBBUF_SIZE
, len
);
666 /* Get exclusive read access to the next sub-buffer that can be read. */
667 int kernctl_get_next_subbuf(int fd
)
669 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_NEXT_SUBBUF
);
673 /* Release exclusive sub-buffer access, move consumer forward. */
674 int kernctl_put_next_subbuf(int fd
)
676 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_PUT_NEXT_SUBBUF
);
681 /* Get a snapshot of the current ring buffer producer and consumer positions */
682 int kernctl_snapshot(int fd
)
684 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_SNAPSHOT
);
688 * Get a snapshot of the current ring buffer producer and consumer positions,
689 * regardless of whether or not the two positions are contained within the
692 int kernctl_snapshot_sample_positions(int fd
)
694 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_SNAPSHOT_SAMPLE_POSITIONS
);
697 /* Get the consumer position (iteration start) */
698 int kernctl_snapshot_get_consumed(int fd
, unsigned long *pos
)
700 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_SNAPSHOT_GET_CONSUMED
, pos
);
703 /* Get the producer position (iteration end) */
704 int kernctl_snapshot_get_produced(int fd
, unsigned long *pos
)
706 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_SNAPSHOT_GET_PRODUCED
, pos
);
709 /* Get exclusive read access to the specified sub-buffer position */
710 int kernctl_get_subbuf(int fd
, unsigned long *len
)
712 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_GET_SUBBUF
, len
);
715 /* Release exclusive sub-buffer access */
716 int kernctl_put_subbuf(int fd
)
718 return LTTNG_IOCTL_CHECK(fd
, RING_BUFFER_PUT_SUBBUF
);
721 /* Returns the timestamp begin of the current sub-buffer. */
722 int kernctl_get_timestamp_begin(int fd
, uint64_t *timestamp_begin
)
724 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN
,
728 /* Returns the timestamp end of the current sub-buffer. */
729 int kernctl_get_timestamp_end(int fd
, uint64_t *timestamp_end
)
731 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_TIMESTAMP_END
,
735 /* Returns the number of discarded events in the current sub-buffer. */
736 int kernctl_get_events_discarded(int fd
, uint64_t *events_discarded
)
738 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED
,
742 /* Returns the content size in the current sub-buffer. */
743 int kernctl_get_content_size(int fd
, uint64_t *content_size
)
745 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_CONTENT_SIZE
,
749 /* Returns the packet size in the current sub-buffer. */
750 int kernctl_get_packet_size(int fd
, uint64_t *packet_size
)
752 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_PACKET_SIZE
,
756 /* Returns the stream id of the current sub-buffer. */
757 int kernctl_get_stream_id(int fd
, uint64_t *stream_id
)
759 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_STREAM_ID
,
763 /* Returns the current timestamp. */
764 int kernctl_get_current_timestamp(int fd
, uint64_t *ts
)
766 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP
,
770 /* Returns the packet sequence number of the current sub-buffer. */
771 int kernctl_get_sequence_number(int fd
, uint64_t *seq
)
773 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_GET_SEQ_NUM
, seq
);
776 /* Returns the stream instance id. */
777 int kernctl_get_instance_id(int fd
, uint64_t *id
)
779 return LTTNG_IOCTL_CHECK(fd
, LTTNG_RING_BUFFER_INSTANCE_ID
, id
);