2 * Copyright (C) 2011 Julien Desfossez <julien.desfossez@polymtl.ca>
3 * Copyright (C) 2011 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
5 * SPDX-License-Identifier: GPL-2.0-only
9 #ifndef _LTT_KERNEL_IOCTL_H
10 #define _LTT_KERNEL_IOCTL_H
12 #define LTTNG_MODULES_ABI_MAJOR_VERSION 2
13 #define LTTNG_MODULES_ABI_MINOR_VERSION 5
15 /* Get a snapshot of the current ring buffer producer and consumer positions */
16 #define RING_BUFFER_SNAPSHOT _IO(0xF6, 0x00)
17 /* Get the consumer position (iteration start) */
18 #define RING_BUFFER_SNAPSHOT_GET_CONSUMED _IOR(0xF6, 0x01, unsigned long)
19 /* Get the producer position (iteration end) */
20 #define RING_BUFFER_SNAPSHOT_GET_PRODUCED _IOR(0xF6, 0x02, unsigned long)
21 /* Get exclusive read access to the specified sub-buffer position */
22 #define RING_BUFFER_GET_SUBBUF _IOW(0xF6, 0x03, unsigned long)
23 /* Release exclusive sub-buffer access */
24 #define RING_BUFFER_PUT_SUBBUF _IO(0xF6, 0x04)
26 /* Get exclusive read access to the next sub-buffer that can be read. */
27 #define RING_BUFFER_GET_NEXT_SUBBUF _IO(0xF6, 0x05)
28 /* Release exclusive sub-buffer access, move consumer forward. */
29 #define RING_BUFFER_PUT_NEXT_SUBBUF _IO(0xF6, 0x06)
30 /* returns the size of the current sub-buffer, without padding (for mmap). */
31 #define RING_BUFFER_GET_SUBBUF_SIZE _IOR(0xF6, 0x07, unsigned long)
32 /* returns the size of the current sub-buffer, with padding (for splice). */
33 #define RING_BUFFER_GET_PADDED_SUBBUF_SIZE _IOR(0xF6, 0x08, unsigned long)
34 /* returns the maximum size for sub-buffers. */
35 #define RING_BUFFER_GET_MAX_SUBBUF_SIZE _IOR(0xF6, 0x09, unsigned long)
36 /* returns the length to mmap. */
37 #define RING_BUFFER_GET_MMAP_LEN _IOR(0xF6, 0x0A, unsigned long)
38 /* returns the offset of the subbuffer belonging to the mmap reader. */
39 #define RING_BUFFER_GET_MMAP_READ_OFFSET _IOR(0xF6, 0x0B, unsigned long)
40 /* Flush the current sub-buffer, if non-empty. */
41 #define RING_BUFFER_FLUSH _IO(0xF6, 0x0C)
42 /* Get the current version of the metadata cache (after a get_next). */
43 #define RING_BUFFER_GET_METADATA_VERSION _IOR(0xF6, 0x0D, uint64_t)
45 * Get a snapshot of the current ring buffer producer and consumer positions,
46 * regardless of whether or not the two positions are contained within the same
49 #define RING_BUFFER_SNAPSHOT_SAMPLE_POSITIONS _IO(0xF6, 0x0E)
50 /* Flush the current sub-buffer, even if empty. */
51 #define RING_BUFFER_FLUSH_EMPTY _IO(0xF6, 0x0F)
53 * Reset the position of what has been consumed from the metadata cache to 0
54 * so it can be read again.
56 #define RING_BUFFER_METADATA_CACHE_DUMP _IO(0xF6, 0x10)
57 /* Clear ring buffer content */
58 #define RING_BUFFER_CLEAR _IO(0xF6, 0x11)
60 /* returns the timestamp begin of the current sub-buffer */
61 #define LTTNG_RING_BUFFER_GET_TIMESTAMP_BEGIN _IOR(0xF6, 0x20, uint64_t)
62 /* returns the timestamp end of the current sub-buffer */
63 #define LTTNG_RING_BUFFER_GET_TIMESTAMP_END _IOR(0xF6, 0x21, uint64_t)
64 /* returns the number of events discarded */
65 #define LTTNG_RING_BUFFER_GET_EVENTS_DISCARDED _IOR(0xF6, 0x22, uint64_t)
66 /* returns the packet payload size */
67 #define LTTNG_RING_BUFFER_GET_CONTENT_SIZE _IOR(0xF6, 0x23, uint64_t)
68 /* returns the actual packet size */
69 #define LTTNG_RING_BUFFER_GET_PACKET_SIZE _IOR(0xF6, 0x24, uint64_t)
70 /* returns the stream id */
71 #define LTTNG_RING_BUFFER_GET_STREAM_ID _IOR(0xF6, 0x25, uint64_t)
72 /* returns the current timestamp */
73 #define LTTNG_RING_BUFFER_GET_CURRENT_TIMESTAMP _IOR(0xF6, 0x26, uint64_t)
74 /* returns the packet sequence number */
75 #define LTTNG_RING_BUFFER_GET_SEQ_NUM _IOR(0xF6, 0x27, uint64_t)
76 /* returns the stream instance id */
77 #define LTTNG_RING_BUFFER_INSTANCE_ID _IOR(0xF6, 0x28, uint64_t)
79 /* Old ABI (without support for 32/64 bits compat) */
80 /* LTTng file descriptor ioctl */
81 #define LTTNG_KERNEL_OLD_SESSION _IO(0xF6, 0x40)
82 #define LTTNG_KERNEL_OLD_TRACER_VERSION \
83 _IOR(0xF6, 0x41, struct lttng_kernel_old_tracer_version)
84 #define LTTNG_KERNEL_OLD_TRACEPOINT_LIST _IO(0xF6, 0x42)
85 #define LTTNG_KERNEL_OLD_WAIT_QUIESCENT _IO(0xF6, 0x43)
87 /* Session FD ioctl */
88 #define LTTNG_KERNEL_OLD_METADATA \
89 _IOW(0xF6, 0x50, struct lttng_kernel_old_channel)
90 #define LTTNG_KERNEL_OLD_CHANNEL \
91 _IOW(0xF6, 0x51, struct lttng_kernel_old_channel)
92 #define LTTNG_KERNEL_OLD_SESSION_START _IO(0xF6, 0x52)
93 #define LTTNG_KERNEL_OLD_SESSION_STOP _IO(0xF6, 0x53)
95 /* Channel FD ioctl */
96 #define LTTNG_KERNEL_OLD_STREAM _IO(0xF6, 0x60)
97 #define LTTNG_KERNEL_OLD_EVENT \
98 _IOW(0xF6, 0x61, struct lttng_kernel_old_event)
100 /* Event and Channel FD ioctl */
101 #define LTTNG_KERNEL_OLD_CONTEXT \
102 _IOW(0xF6, 0x70, struct lttng_kernel_old_context)
104 /* Event, Channel and Session ioctl */
105 #define LTTNG_KERNEL_OLD_ENABLE _IO(0xF6, 0x80)
106 #define LTTNG_KERNEL_OLD_DISABLE _IO(0xF6, 0x81)
109 /* Current ABI (with suport for 32/64 bits compat) */
110 /* LTTng file descriptor ioctl */
111 #define LTTNG_KERNEL_SESSION _IO(0xF6, 0x45)
112 #define LTTNG_KERNEL_TRACER_VERSION \
113 _IOR(0xF6, 0x46, struct lttng_kernel_tracer_version)
114 #define LTTNG_KERNEL_TRACEPOINT_LIST _IO(0xF6, 0x47)
115 #define LTTNG_KERNEL_WAIT_QUIESCENT _IO(0xF6, 0x48)
116 #define LTTNG_KERNEL_SYSCALL_LIST _IO(0xF6, 0x4A)
117 #define LTTNG_KERNEL_TRACER_ABI_VERSION \
118 _IOR(0xF6, 0x4B, struct lttng_kernel_tracer_abi_version)
120 /* Session FD ioctl */
121 #define LTTNG_KERNEL_METADATA \
122 _IOW(0xF6, 0x54, struct lttng_kernel_channel)
123 #define LTTNG_KERNEL_CHANNEL \
124 _IOW(0xF6, 0x55, struct lttng_kernel_channel)
125 #define LTTNG_KERNEL_SESSION_START _IO(0xF6, 0x56)
126 #define LTTNG_KERNEL_SESSION_STOP _IO(0xF6, 0x57)
127 #define LTTNG_KERNEL_SESSION_TRACK_PID \
128 _IOR(0xF6, 0x58, int32_t)
129 #define LTTNG_KERNEL_SESSION_UNTRACK_PID \
130 _IOR(0xF6, 0x59, int32_t)
132 * ioctl 0x58 and 0x59 are duplicated here. It works, since _IOR vs _IO
133 * are generating two different ioctl numbers, but this was not done on
134 * purpose. We should generally try to avoid those duplications.
136 #define LTTNG_KERNEL_SESSION_LIST_TRACKER_PIDS _IO(0xF6, 0x58)
137 #define LTTNG_KERNEL_SESSION_METADATA_REGEN _IO(0xF6, 0x59)
138 /* 0x5A and 0x5B are reserved for a future ABI-breaking cleanup. */
139 #define LTTNG_KERNEL_SESSION_STATEDUMP _IO(0xF6, 0x5C)
140 #define LTTNG_KERNEL_SESSION_SET_NAME \
141 _IOR(0xF6, 0x5D, struct lttng_kernel_session_name)
142 #define LTTNG_KERNEL_SESSION_SET_CREATION_TIME \
143 _IOR(0xF6, 0x5E, struct lttng_kernel_session_creation_time)
145 /* Channel FD ioctl */
146 #define LTTNG_KERNEL_STREAM _IO(0xF6, 0x62)
147 #define LTTNG_KERNEL_EVENT \
148 _IOW(0xF6, 0x63, struct lttng_kernel_event)
149 #define LTTNG_KERNEL_SYSCALL_MASK \
150 _IOWR(0xF6, 0x64, struct lttng_kernel_syscall_mask)
152 /* Event and Channel FD ioctl */
153 #define LTTNG_KERNEL_CONTEXT \
154 _IOW(0xF6, 0x71, struct lttng_kernel_context)
156 /* Event, Channel and Session ioctl */
157 #define LTTNG_KERNEL_ENABLE _IO(0xF6, 0x82)
158 #define LTTNG_KERNEL_DISABLE _IO(0xF6, 0x83)
161 #define LTTNG_KERNEL_FILTER _IO(0xF6, 0x90)
162 #define LTTNG_KERNEL_ADD_CALLSITE _IO(0xF6, 0x91)
164 /* Session FD ioctl (continued) */
165 #define LTTNG_KERNEL_SESSION_LIST_TRACKER_IDS \
166 _IOR(0xF6, 0xA0, struct lttng_kernel_tracker_args)
167 #define LTTNG_KERNEL_SESSION_TRACK_ID \
168 _IOR(0xF6, 0xA1, struct lttng_kernel_tracker_args)
169 #define LTTNG_KERNEL_SESSION_UNTRACK_ID \
170 _IOR(0xF6, 0xA2, struct lttng_kernel_tracker_args)
172 #endif /* _LTT_KERNEL_IOCTL_H */
This page took 0.035648 seconds and 5 git commands to generate.