Rename struct lib_ring_buffer_ctx to struct lttng_kernel_ring_buffer_ctx
[lttng-modules.git] / src / lttng-ring-buffer-event-notifier-client.h
CommitLineData
250c663f
MD
1/* SPDX-License-Identifier: (GPL-2.0 or LGPL-2.1)
2 *
3 * lttng-ring-buffer-event-notifier-client.h
4 *
5 * LTTng lib ring buffer event notifier client template.
6 *
7 * Copyright (C) 2010-2020 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
8 */
9
99d223ad 10#include <linux/limits.h>
250c663f
MD
11#include <linux/module.h>
12#include <linux/types.h>
13#include <wrapper/vmalloc.h> /* for wrapper_vmalloc_sync_mappings() */
99d223ad 14#include <lttng/abi.h>
250c663f 15#include <lttng/events.h>
e8c0bbd3 16#include <lttng/events-internal.h>
250c663f 17#include <lttng/tracer.h>
236233f7 18#include <wrapper/limits.h>
250c663f
MD
19
20static struct lttng_transport lttng_relay_transport;
21
22struct event_notifier_packet_header {
23 uint8_t header_end[0];
24};
25
26struct event_notifier_record_header {
99d223ad 27 uint32_t payload_len; /* in bytes */
250c663f
MD
28 uint8_t header_end[0]; /* End of header */
29};
30
31static const struct lib_ring_buffer_config client_config;
32
33static inline
34u64 lib_ring_buffer_clock_read(struct channel *chan)
35{
36 return 0;
37}
38
39static inline
40size_t record_header_size(const struct lib_ring_buffer_config *config,
41 struct channel *chan, size_t offset,
42 size_t *pre_header_padding,
8a57ec02 43 struct lttng_kernel_ring_buffer_ctx *ctx,
250c663f
MD
44 void *client_ctx)
45{
99d223ad
FD
46 size_t orig_offset = offset;
47 size_t padding;
48
49 padding = lib_ring_buffer_align(offset, lttng_alignof(uint32_t));
50 offset += padding;
51
52 offset += sizeof(uint32_t);
53
54 *pre_header_padding = padding;
55
56 return offset - orig_offset;
250c663f
MD
57}
58
59#include <ringbuffer/api.h>
60
61static u64 client_ring_buffer_clock_read(struct channel *chan)
62{
63 return 0;
64}
65
66static
67size_t client_record_header_size(const struct lib_ring_buffer_config *config,
68 struct channel *chan, size_t offset,
69 size_t *pre_header_padding,
8a57ec02 70 struct lttng_kernel_ring_buffer_ctx *ctx,
250c663f
MD
71 void *client_ctx)
72{
99d223ad
FD
73 return record_header_size(config, chan, offset,
74 pre_header_padding, ctx, client_ctx);
250c663f
MD
75}
76
77/**
78 * client_packet_header_size - called on buffer-switch to a new sub-buffer
79 *
80 * Return header size without padding after the structure. Don't use packed
81 * structure because gcc generates inefficient code on some architectures
82 * (powerpc, mips..)
83 */
84static size_t client_packet_header_size(void)
85{
86 return offsetof(struct event_notifier_packet_header, header_end);
87}
88
89static void client_buffer_begin(struct lib_ring_buffer *buf, u64 tsc,
90 unsigned int subbuf_idx)
91{
92}
93
94/*
95 * offset is assumed to never be 0 here : never deliver a completely empty
96 * subbuffer. data_size is between 1 and subbuf_size.
97 */
98static void client_buffer_end(struct lib_ring_buffer *buf, u64 tsc,
99 unsigned int subbuf_idx, unsigned long data_size)
100{
101}
102
103static int client_buffer_create(struct lib_ring_buffer *buf, void *priv,
104 int cpu, const char *name)
105{
106 return 0;
107}
108
109static void client_buffer_finalize(struct lib_ring_buffer *buf, void *priv, int cpu)
110{
111}
112
113static int client_timestamp_begin(const struct lib_ring_buffer_config *config,
114 struct lib_ring_buffer *buf, uint64_t *timestamp_begin)
115{
116 return -ENOSYS;
117}
118
119static int client_timestamp_end(const struct lib_ring_buffer_config *config,
120 struct lib_ring_buffer *bufb,
121 uint64_t *timestamp_end)
122{
123 return -ENOSYS;
124}
125
126static int client_events_discarded(const struct lib_ring_buffer_config *config,
127 struct lib_ring_buffer *bufb,
128 uint64_t *events_discarded)
129{
130 return -ENOSYS;
131}
132
133static int client_current_timestamp(const struct lib_ring_buffer_config *config,
134 struct lib_ring_buffer *bufb,
135 uint64_t *ts)
136{
137 return -ENOSYS;
138}
139
140static int client_content_size(const struct lib_ring_buffer_config *config,
141 struct lib_ring_buffer *bufb,
142 uint64_t *content_size)
143{
144 return -ENOSYS;
145}
146
147static int client_packet_size(const struct lib_ring_buffer_config *config,
148 struct lib_ring_buffer *bufb,
149 uint64_t *packet_size)
150{
151 return -ENOSYS;
152}
153
154static int client_stream_id(const struct lib_ring_buffer_config *config,
155 struct lib_ring_buffer *bufb,
156 uint64_t *stream_id)
157{
158 return -ENOSYS;
159}
160
161static int client_sequence_number(const struct lib_ring_buffer_config *config,
162 struct lib_ring_buffer *bufb,
163 uint64_t *seq)
164{
165 return -ENOSYS;
166}
167
168static
169int client_instance_id(const struct lib_ring_buffer_config *config,
170 struct lib_ring_buffer *bufb,
171 uint64_t *id)
172{
173 return -ENOSYS;
174}
175
176static void client_record_get(const struct lib_ring_buffer_config *config,
177 struct channel *chan, struct lib_ring_buffer *buf,
178 size_t offset, size_t *header_len,
179 size_t *payload_len, u64 *timestamp)
180{
181 struct event_notifier_record_header header;
182 int ret;
183
184 ret = lib_ring_buffer_read(&buf->backend, offset, &header,
185 offsetof(struct event_notifier_record_header, header_end));
186 CHAN_WARN_ON(chan, ret != offsetof(struct event_notifier_record_header, header_end));
187 *header_len = offsetof(struct event_notifier_record_header, header_end);
99d223ad 188 *payload_len = header.payload_len;
250c663f
MD
189 *timestamp = 0;
190}
191
192static const struct lib_ring_buffer_config client_config = {
193 .cb.ring_buffer_clock_read = client_ring_buffer_clock_read,
194 .cb.record_header_size = client_record_header_size,
195 .cb.subbuffer_header_size = client_packet_header_size,
196 .cb.buffer_begin = client_buffer_begin,
197 .cb.buffer_end = client_buffer_end,
198 .cb.buffer_create = client_buffer_create,
199 .cb.buffer_finalize = client_buffer_finalize,
200 .cb.record_get = client_record_get,
201
202 .tsc_bits = 0,
203 .alloc = RING_BUFFER_ALLOC_GLOBAL,
204 .sync = RING_BUFFER_SYNC_GLOBAL,
205 .mode = RING_BUFFER_MODE_TEMPLATE,
206 .backend = RING_BUFFER_PAGE,
207 .output = RING_BUFFER_OUTPUT_TEMPLATE,
208 .oops = RING_BUFFER_OOPS_CONSISTENCY,
209 .ipi = RING_BUFFER_NO_IPI_BARRIER,
210 .wakeup = RING_BUFFER_WAKEUP_BY_WRITER,
211};
212
213static
214void release_priv_ops(void *priv_ops)
215{
216 module_put(THIS_MODULE);
217}
218
219static
220void lttng_channel_destroy(struct channel *chan)
221{
222 channel_destroy(chan);
223}
224
225static
226struct channel *_channel_create(const char *name,
227 void *priv, void *buf_addr,
228 size_t subbuf_size, size_t num_subbuf,
229 unsigned int switch_timer_interval,
230 unsigned int read_timer_interval)
231{
232 struct lttng_event_notifier_group *event_notifier_group = priv;
233 struct channel *chan;
234
235 chan = channel_create(&client_config, name,
236 event_notifier_group, buf_addr,
237 subbuf_size, num_subbuf, switch_timer_interval,
238 read_timer_interval);
239 if (chan) {
240 /*
241 * Ensure this module is not unloaded before we finish
242 * using lttng_relay_transport.ops.
243 */
244 if (!try_module_get(THIS_MODULE)) {
245 printk(KERN_WARNING "LTTng: Can't lock event_notifier transport module.\n");
246 goto error;
247 }
248 chan->backend.priv_ops = &lttng_relay_transport.ops;
249 chan->backend.release_priv_ops = release_priv_ops;
250 }
251 return chan;
252
253error:
254 lttng_channel_destroy(chan);
255 return NULL;
256}
257
258static
259struct lib_ring_buffer *lttng_buffer_read_open(struct channel *chan)
260{
261 struct lib_ring_buffer *buf;
262
263 buf = channel_get_ring_buffer(&client_config, chan, 0);
264 if (!lib_ring_buffer_open_read(buf))
265 return buf;
266 return NULL;
267}
268
269static
270int lttng_buffer_has_read_closed_stream(struct channel *chan)
271{
272 struct lib_ring_buffer *buf;
273 int cpu;
274
275 for_each_channel_cpu(cpu, chan) {
276 buf = channel_get_ring_buffer(&client_config, chan, cpu);
277 if (!atomic_long_read(&buf->active_readers))
278 return 1;
279 }
280 return 0;
281}
282
283static
284void lttng_buffer_read_close(struct lib_ring_buffer *buf)
285{
286 lib_ring_buffer_release_read(buf);
287}
288
99d223ad
FD
289static
290void lttng_write_event_notifier_header(const struct lib_ring_buffer_config *config,
8a57ec02 291 struct lttng_kernel_ring_buffer_ctx *ctx)
99d223ad
FD
292{
293 uint32_t data_size;
294
295 WARN_ON_ONCE(ctx->data_size > U32_MAX);
296
297 data_size = (uint32_t) ctx->data_size;
298
299 lib_ring_buffer_write(config, ctx, &data_size, sizeof(data_size));
300
301 lib_ring_buffer_align_ctx(ctx, ctx->largest_align);
302}
303
250c663f 304static
8a57ec02 305int lttng_event_reserve(struct lttng_kernel_ring_buffer_ctx *ctx)
250c663f 306{
b1199bd3 307 struct channel *chan = ctx->client_priv;
250c663f
MD
308 int ret;
309
b1199bd3
MD
310 memset(&ctx->priv, 0, sizeof(ctx->priv));
311 ctx->priv.chan = chan;
312
250c663f
MD
313 ret = lib_ring_buffer_reserve(&client_config, ctx, NULL);
314 if (ret)
315 return ret;
316 lib_ring_buffer_backend_get_pages(&client_config, ctx,
b1199bd3 317 &ctx->priv.backend_pages);
99d223ad
FD
318
319 lttng_write_event_notifier_header(&client_config, ctx);
250c663f
MD
320 return 0;
321}
322
323static
8a57ec02 324void lttng_event_commit(struct lttng_kernel_ring_buffer_ctx *ctx)
250c663f
MD
325{
326 lib_ring_buffer_commit(&client_config, ctx);
327}
328
329static
8a57ec02 330void lttng_event_write(struct lttng_kernel_ring_buffer_ctx *ctx, const void *src,
250c663f
MD
331 size_t len)
332{
333 lib_ring_buffer_write(&client_config, ctx, src, len);
334}
335
336static
8a57ec02 337void lttng_event_write_from_user(struct lttng_kernel_ring_buffer_ctx *ctx,
250c663f
MD
338 const void __user *src, size_t len)
339{
340 lib_ring_buffer_copy_from_user_inatomic(&client_config, ctx, src, len);
341}
342
343static
8a57ec02 344void lttng_event_memset(struct lttng_kernel_ring_buffer_ctx *ctx,
250c663f
MD
345 int c, size_t len)
346{
347 lib_ring_buffer_memset(&client_config, ctx, c, len);
348}
349
350static
8a57ec02 351void lttng_event_strcpy(struct lttng_kernel_ring_buffer_ctx *ctx, const char *src,
250c663f
MD
352 size_t len)
353{
354 lib_ring_buffer_strcpy(&client_config, ctx, src, len, '#');
355}
356
357static
358size_t lttng_packet_avail_size(struct channel *chan)
359{
360 unsigned long o_begin;
361 struct lib_ring_buffer *buf;
362
363 buf = chan->backend.buf; /* Only for global buffer ! */
364 o_begin = v_read(&client_config, &buf->offset);
365 if (subbuf_offset(o_begin, chan) != 0) {
366 return chan->backend.subbuf_size - subbuf_offset(o_begin, chan);
367 } else {
368 return chan->backend.subbuf_size - subbuf_offset(o_begin, chan)
369 - sizeof(struct event_notifier_packet_header);
370 }
371}
372
373static
374wait_queue_head_t *lttng_get_writer_buf_wait_queue(struct channel *chan, int cpu)
375{
376 struct lib_ring_buffer *buf = channel_get_ring_buffer(&client_config,
377 chan, cpu);
378 return &buf->write_wait;
379}
380
381static
382wait_queue_head_t *lttng_get_hp_wait_queue(struct channel *chan)
383{
384 return &chan->hp_wait;
385}
386
387static
388int lttng_is_finalized(struct channel *chan)
389{
390 return lib_ring_buffer_channel_is_finalized(chan);
391}
392
393static
394int lttng_is_disabled(struct channel *chan)
395{
396 return lib_ring_buffer_channel_is_disabled(chan);
397}
398
399static struct lttng_transport lttng_relay_transport = {
400 .name = "relay-" RING_BUFFER_MODE_TEMPLATE_STRING,
401 .owner = THIS_MODULE,
402 .ops = {
4a399b76
MD
403 .priv = __LTTNG_COMPOUND_LITERAL(struct lttng_kernel_channel_buffer_ops_private, {
404 .pub = &lttng_relay_transport.ops,
405 .channel_create = _channel_create,
406 .channel_destroy = lttng_channel_destroy,
407 .buffer_read_open = lttng_buffer_read_open,
408 .buffer_has_read_closed_stream =
409 lttng_buffer_has_read_closed_stream,
410 .buffer_read_close = lttng_buffer_read_close,
411 .packet_avail_size = lttng_packet_avail_size,
412 .get_writer_buf_wait_queue = lttng_get_writer_buf_wait_queue,
413 .get_hp_wait_queue = lttng_get_hp_wait_queue,
414 .is_finalized = lttng_is_finalized,
415 .is_disabled = lttng_is_disabled,
416 .timestamp_begin = client_timestamp_begin,
417 .timestamp_end = client_timestamp_end,
418 .events_discarded = client_events_discarded,
419 .content_size = client_content_size,
420 .packet_size = client_packet_size,
421 .stream_id = client_stream_id,
422 .current_timestamp = client_current_timestamp,
423 .sequence_number = client_sequence_number,
424 .instance_id = client_instance_id,
425 }),
250c663f
MD
426 .event_reserve = lttng_event_reserve,
427 .event_commit = lttng_event_commit,
428 .event_write_from_user = lttng_event_write_from_user,
429 .event_memset = lttng_event_memset,
430 .event_write = lttng_event_write,
431 .event_strcpy = lttng_event_strcpy,
250c663f
MD
432 },
433};
434
435static int __init lttng_ring_buffer_event_notifier_client_init(void)
436{
437 /*
438 * This vmalloc sync all also takes care of the lib ring buffer
439 * vmalloc'd module pages when it is built as a module into LTTng.
440 */
441 wrapper_vmalloc_sync_mappings();
442 lttng_transport_register(&lttng_relay_transport);
443 return 0;
444}
445
446module_init(lttng_ring_buffer_event_notifier_client_init);
447
448static void __exit lttng_ring_buffer_event_notifier_client_exit(void)
449{
450 lttng_transport_unregister(&lttng_relay_transport);
451}
452
453module_exit(lttng_ring_buffer_event_notifier_client_exit);
454
455MODULE_LICENSE("GPL and additional rights");
456MODULE_AUTHOR("Mathieu Desnoyers <mathieu.desnoyers@efficios.com>");
457MODULE_DESCRIPTION("LTTng ring buffer " RING_BUFFER_MODE_TEMPLATE_STRING
458 " client");
459MODULE_VERSION(__stringify(LTTNG_MODULES_MAJOR_VERSION) "."
460 __stringify(LTTNG_MODULES_MINOR_VERSION) "."
461 __stringify(LTTNG_MODULES_PATCHLEVEL_VERSION)
462 LTTNG_MODULES_EXTRAVERSION);
This page took 0.047184 seconds and 4 git commands to generate.