Update ring buffer and pretty print
[lttng-modules.git] / ltt-ring-buffer-client.h
CommitLineData
7514523f 1/*
3d084699 2 * ltt-ring-buffer-client.h
7514523f
MD
3 *
4 * Copyright (C) 2010 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
5 *
3d084699 6 * LTTng lib ring buffer client template.
7514523f
MD
7 *
8 * Dual LGPL v2.1/GPL v2 license.
9 */
10
11#include <linux/module.h>
c0e31d2e 12#include <linux/types.h>
9115fbdc 13#include "lib/bitfield.h"
b13f3ebe 14#include "wrapper/vmalloc.h" /* for wrapper_vmalloc_sync_all() */
f3bc08c5 15#include "wrapper/trace-clock.h"
c0e31d2e 16#include "ltt-events.h"
7514523f 17#include "ltt-tracer.h"
9115fbdc 18#include "wrapper/ringbuffer/frontend_types.h"
7514523f 19
d793d5e1
MD
20/*
21 * Keep the natural field alignment for _each field_ within this structure if
22 * you ever add/remove a field from this header. Packed attribute is not used
23 * because gcc generates poor code on at least powerpc and mips. Don't ever
24 * let gcc add padding between the structure elements.
25 */
9115fbdc 26
d793d5e1 27struct packet_header {
9115fbdc 28 /* Trace packet header */
d793d5e1
MD
29 uint32_t magic; /*
30 * Trace magic number.
31 * contains endianness information.
32 */
1ec3f75a 33 uint8_t uuid[16];
d793d5e1 34 uint32_t stream_id;
9115fbdc
MD
35
36 struct {
37 /* Stream packet context */
38 uint64_t timestamp_begin; /* Cycle count at subbuffer start */
39 uint64_t timestamp_end; /* Cycle count at subbuffer end */
40 uint32_t events_discarded; /*
41 * Events lost in this subbuffer since
42 * the beginning of the trace.
43 * (may overflow)
44 */
45 uint32_t content_size; /* Size of data in subbuffer */
46 uint32_t packet_size; /* Subbuffer size (include padding) */
47 uint32_t cpu_id; /* CPU id associated with stream */
48 uint8_t header_end; /* End of header */
49 } ctx;
d793d5e1
MD
50};
51
52
881833e3
MD
53static inline notrace u64 lib_ring_buffer_clock_read(struct channel *chan)
54{
55 return trace_clock_read64();
56}
57
58/*
59 * record_header_size - Calculate the header size and padding necessary.
60 * @config: ring buffer instance configuration
61 * @chan: channel
62 * @offset: offset in the write buffer
881833e3 63 * @pre_header_padding: padding to add before the header (output)
881833e3
MD
64 * @ctx: reservation context
65 *
66 * Returns the event header size (including padding).
67 *
881833e3
MD
68 * The payload must itself determine its own alignment from the biggest type it
69 * contains.
70 */
71static __inline__
72unsigned char record_header_size(const struct lib_ring_buffer_config *config,
73 struct channel *chan, size_t offset,
64c796d8 74 size_t *pre_header_padding,
881833e3
MD
75 struct lib_ring_buffer_ctx *ctx)
76{
9115fbdc 77 struct ltt_channel *ltt_chan = channel_get_private(chan);
881833e3
MD
78 size_t orig_offset = offset;
79 size_t padding;
80
9115fbdc
MD
81 switch (ltt_chan->header_type) {
82 case 1: /* compact */
83 padding = lib_ring_buffer_align(offset, ltt_alignof(uint32_t));
84 offset += padding;
64c796d8 85 if (!(ctx->rflags & (RING_BUFFER_RFLAG_FULL_TSC | LTT_RFLAG_EXTENDED))) {
9115fbdc
MD
86 offset += sizeof(uint32_t); /* id and timestamp */
87 } else {
88 /* Minimum space taken by 5-bit id */
89 offset += sizeof(uint8_t);
90 /* Align extended struct on largest member */
91 offset += lib_ring_buffer_align(offset, ltt_alignof(uint64_t));
92 offset += sizeof(uint32_t); /* id */
93 offset += lib_ring_buffer_align(offset, ltt_alignof(uint64_t));
94 offset += sizeof(uint64_t); /* timestamp */
95 }
96 break;
97 case 2: /* large */
98 padding = lib_ring_buffer_align(offset, ltt_alignof(uint16_t));
99 offset += padding;
100 offset += sizeof(uint16_t);
64c796d8 101 if (!(ctx->rflags & (RING_BUFFER_RFLAG_FULL_TSC | LTT_RFLAG_EXTENDED))) {
9115fbdc
MD
102 offset += lib_ring_buffer_align(offset, ltt_alignof(uint32_t));
103 offset += sizeof(uint32_t); /* timestamp */
104 } else {
105 /* Align extended struct on largest member */
106 offset += lib_ring_buffer_align(offset, ltt_alignof(uint64_t));
107 offset += sizeof(uint32_t); /* id */
108 offset += lib_ring_buffer_align(offset, ltt_alignof(uint64_t));
109 offset += sizeof(uint64_t); /* timestamp */
110
881833e3 111 }
9115fbdc
MD
112 break;
113 default:
64c796d8 114 WARN_ON_ONCE(1);
881833e3
MD
115 }
116
117 *pre_header_padding = padding;
118 return offset - orig_offset;
119}
120
121#include "wrapper/ringbuffer/api.h"
122
123extern
124void ltt_write_event_header_slow(const struct lib_ring_buffer_config *config,
125 struct lib_ring_buffer_ctx *ctx,
64c796d8 126 uint32_t event_id);
881833e3
MD
127
128/*
129 * ltt_write_event_header
130 *
131 * Writes the event header to the offset (already aligned on 32-bits).
132 *
133 * @config: ring buffer instance configuration
134 * @ctx: reservation context
4e1f08f4 135 * @event_id: event ID
881833e3
MD
136 */
137static __inline__
138void ltt_write_event_header(const struct lib_ring_buffer_config *config,
139 struct lib_ring_buffer_ctx *ctx,
64c796d8 140 uint32_t event_id)
881833e3 141{
9115fbdc 142 struct ltt_channel *ltt_chan = channel_get_private(ctx->chan);
881833e3
MD
143
144 if (unlikely(ctx->rflags))
145 goto slow_path;
146
9115fbdc
MD
147 switch (ltt_chan->header_type) {
148 case 1: /* compact */
149 {
150 uint32_t id_time = 0;
151
4e1f08f4 152 bt_bitfield_write(&id_time, uint32_t, 0, 5, event_id);
9115fbdc
MD
153 bt_bitfield_write(&id_time, uint32_t, 5, 27, ctx->tsc);
154 lib_ring_buffer_write(config, ctx, &id_time, sizeof(id_time));
155 break;
156 }
157 case 2: /* large */
158 {
9115fbdc
MD
159 uint32_t timestamp = (uint32_t) ctx->tsc;
160
161 lib_ring_buffer_write(config, ctx, &event_id, sizeof(event_id));
162 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint32_t));
163 lib_ring_buffer_write(config, ctx, &timestamp, sizeof(timestamp));
164 break;
165 }
166 default:
64c796d8 167 WARN_ON_ONCE(1);
9115fbdc
MD
168 }
169 return;
881833e3
MD
170
171slow_path:
4e1f08f4 172 ltt_write_event_header_slow(config, ctx, event_id);
881833e3
MD
173}
174
881833e3 175void ltt_write_event_header_slow(const struct lib_ring_buffer_config *config,
64c796d8
MD
176 struct lib_ring_buffer_ctx *ctx,
177 uint32_t event_id)
881833e3 178{
9115fbdc
MD
179 struct ltt_channel *ltt_chan = channel_get_private(ctx->chan);
180
181 switch (ltt_chan->header_type) {
182 case 1: /* compact */
64c796d8 183 if (!(ctx->rflags & (RING_BUFFER_RFLAG_FULL_TSC | LTT_RFLAG_EXTENDED))) {
9115fbdc
MD
184 uint32_t id_time = 0;
185
4e1f08f4 186 bt_bitfield_write(&id_time, uint32_t, 0, 5, event_id);
9115fbdc
MD
187 bt_bitfield_write(&id_time, uint32_t, 5, 27, ctx->tsc);
188 lib_ring_buffer_write(config, ctx, &id_time, sizeof(id_time));
189 } else {
190 uint8_t id = 0;
4e1f08f4 191 uint32_t event_id = (uint32_t) event_id;
9115fbdc
MD
192 uint64_t timestamp = ctx->tsc;
193
194 bt_bitfield_write(&id, uint8_t, 0, 5, 31);
195 lib_ring_buffer_write(config, ctx, &id, sizeof(id));
196 /* Align extended struct on largest member */
197 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint64_t));
198 lib_ring_buffer_write(config, ctx, &event_id, sizeof(event_id));
199 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint64_t));
200 lib_ring_buffer_write(config, ctx, &timestamp, sizeof(timestamp));
201 }
881833e3 202 break;
9115fbdc
MD
203 case 2: /* large */
204 {
64c796d8 205 if (!(ctx->rflags & (RING_BUFFER_RFLAG_FULL_TSC | LTT_RFLAG_EXTENDED))) {
9115fbdc
MD
206 uint32_t timestamp = (uint32_t) ctx->tsc;
207
208 lib_ring_buffer_write(config, ctx, &event_id, sizeof(event_id));
209 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint32_t));
210 lib_ring_buffer_write(config, ctx, &timestamp, sizeof(timestamp));
211 } else {
64c796d8 212 uint16_t id = 65535;
9115fbdc
MD
213 uint64_t timestamp = ctx->tsc;
214
64c796d8 215 lib_ring_buffer_write(config, ctx, &id, sizeof(id));
9115fbdc
MD
216 /* Align extended struct on largest member */
217 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint64_t));
64c796d8 218 lib_ring_buffer_write(config, ctx, &event_id, sizeof(event_id));
9115fbdc
MD
219 lib_ring_buffer_align_ctx(ctx, ltt_alignof(uint64_t));
220 lib_ring_buffer_write(config, ctx, &timestamp, sizeof(timestamp));
221 }
881833e3 222 break;
881833e3 223 }
9115fbdc 224 default:
64c796d8 225 WARN_ON_ONCE(1);
881833e3
MD
226 }
227}
228
7514523f
MD
229static const struct lib_ring_buffer_config client_config;
230
231static u64 client_ring_buffer_clock_read(struct channel *chan)
232{
233 return lib_ring_buffer_clock_read(chan);
234}
235
1e2015dc 236static
7514523f
MD
237size_t client_record_header_size(const struct lib_ring_buffer_config *config,
238 struct channel *chan, size_t offset,
7514523f 239 size_t *pre_header_padding,
7514523f
MD
240 struct lib_ring_buffer_ctx *ctx)
241{
64c796d8
MD
242 return record_header_size(config, chan, offset,
243 pre_header_padding, ctx);
7514523f
MD
244}
245
246/**
1c25284c 247 * client_packet_header_size - called on buffer-switch to a new sub-buffer
7514523f
MD
248 *
249 * Return header size without padding after the structure. Don't use packed
250 * structure because gcc generates inefficient code on some architectures
251 * (powerpc, mips..)
252 */
1c25284c 253static size_t client_packet_header_size(void)
7514523f 254{
9115fbdc 255 return offsetof(struct packet_header, ctx.header_end);
7514523f
MD
256}
257
258static void client_buffer_begin(struct lib_ring_buffer *buf, u64 tsc,
259 unsigned int subbuf_idx)
260{
261 struct channel *chan = buf->backend.chan;
1c25284c
MD
262 struct packet_header *header =
263 (struct packet_header *)
7514523f
MD
264 lib_ring_buffer_offset_address(&buf->backend,
265 subbuf_idx * chan->backend.subbuf_size);
9115fbdc
MD
266 struct ltt_channel *ltt_chan = channel_get_private(chan);
267 struct ltt_session *session = ltt_chan->session;
7514523f 268
d793d5e1 269 header->magic = CTF_MAGIC_NUMBER;
1ec3f75a 270 memcpy(header->uuid, session->uuid.b, sizeof(session->uuid));
9115fbdc
MD
271 header->stream_id = ltt_chan->id;
272 header->ctx.timestamp_begin = tsc;
273 header->ctx.timestamp_end = 0;
274 header->ctx.events_discarded = 0;
275 header->ctx.content_size = 0xFFFFFFFF; /* for debugging */
276 header->ctx.packet_size = 0xFFFFFFFF;
277 header->ctx.cpu_id = buf->backend.cpu;
7514523f
MD
278}
279
280/*
281 * offset is assumed to never be 0 here : never deliver a completely empty
282 * subbuffer. data_size is between 1 and subbuf_size.
283 */
284static void client_buffer_end(struct lib_ring_buffer *buf, u64 tsc,
285 unsigned int subbuf_idx, unsigned long data_size)
286{
287 struct channel *chan = buf->backend.chan;
1c25284c
MD
288 struct packet_header *header =
289 (struct packet_header *)
7514523f
MD
290 lib_ring_buffer_offset_address(&buf->backend,
291 subbuf_idx * chan->backend.subbuf_size);
292 unsigned long records_lost = 0;
293
9115fbdc 294 header->ctx.timestamp_end = tsc;
05d32c64
MD
295 header->ctx.content_size = data_size * CHAR_BIT; /* in bits */
296 header->ctx.packet_size = PAGE_ALIGN(data_size) * CHAR_BIT; /* in bits */
7514523f
MD
297 records_lost += lib_ring_buffer_get_records_lost_full(&client_config, buf);
298 records_lost += lib_ring_buffer_get_records_lost_wrap(&client_config, buf);
299 records_lost += lib_ring_buffer_get_records_lost_big(&client_config, buf);
9115fbdc 300 header->ctx.events_discarded = records_lost;
7514523f
MD
301}
302
303static int client_buffer_create(struct lib_ring_buffer *buf, void *priv,
304 int cpu, const char *name)
305{
1c25284c 306 return 0;
7514523f
MD
307}
308
309static void client_buffer_finalize(struct lib_ring_buffer *buf, void *priv, int cpu)
310{
7514523f
MD
311}
312
313static const struct lib_ring_buffer_config client_config = {
314 .cb.ring_buffer_clock_read = client_ring_buffer_clock_read,
315 .cb.record_header_size = client_record_header_size,
1c25284c 316 .cb.subbuffer_header_size = client_packet_header_size,
7514523f
MD
317 .cb.buffer_begin = client_buffer_begin,
318 .cb.buffer_end = client_buffer_end,
319 .cb.buffer_create = client_buffer_create,
320 .cb.buffer_finalize = client_buffer_finalize,
321
322 .tsc_bits = 32,
323 .alloc = RING_BUFFER_ALLOC_PER_CPU,
324 .sync = RING_BUFFER_SYNC_PER_CPU,
3d084699 325 .mode = RING_BUFFER_MODE_TEMPLATE,
7514523f
MD
326 .backend = RING_BUFFER_PAGE,
327 .output = RING_BUFFER_SPLICE,
328 .oops = RING_BUFFER_OOPS_CONSISTENCY,
329 .ipi = RING_BUFFER_IPI_BARRIER,
330 .wakeup = RING_BUFFER_WAKEUP_BY_TIMER,
331};
332
1e2015dc 333static
1c25284c 334struct channel *_channel_create(const char *name,
9115fbdc 335 struct ltt_channel *ltt_chan, void *buf_addr,
1c25284c
MD
336 size_t subbuf_size, size_t num_subbuf,
337 unsigned int switch_timer_interval,
338 unsigned int read_timer_interval)
7514523f 339{
9115fbdc 340 return channel_create(&client_config, name, ltt_chan, buf_addr,
7514523f
MD
341 subbuf_size, num_subbuf, switch_timer_interval,
342 read_timer_interval);
7514523f
MD
343}
344
1e2015dc 345static
7514523f
MD
346void ltt_channel_destroy(struct channel *chan)
347{
7514523f 348 channel_destroy(chan);
7514523f
MD
349}
350
ad1c05e1
MD
351static
352struct lib_ring_buffer *ltt_buffer_read_open(struct channel *chan)
353{
354 struct lib_ring_buffer *buf;
355 int cpu;
356
1c25284c
MD
357 for_each_channel_cpu(cpu, chan) {
358 buf = channel_get_ring_buffer(&client_config, chan, cpu);
ad1c05e1
MD
359 if (!lib_ring_buffer_open_read(buf))
360 return buf;
361 }
362 return NULL;
363}
364
365static
1c25284c 366void ltt_buffer_read_close(struct lib_ring_buffer *buf)
ad1c05e1
MD
367{
368 lib_ring_buffer_release_read(buf);
1c25284c
MD
369
370}
371
c099397a 372static
4e1f08f4 373int ltt_event_reserve(struct lib_ring_buffer_ctx *ctx,
64c796d8 374 uint32_t event_id)
1c25284c 375{
64c796d8 376 struct ltt_channel *ltt_chan = channel_get_private(ctx->chan);
1c25284c
MD
377 int ret, cpu;
378
379 cpu = lib_ring_buffer_get_cpu(&client_config);
380 if (cpu < 0)
381 return -EPERM;
382 ctx->cpu = cpu;
383
64c796d8
MD
384 switch (ltt_chan->header_type) {
385 case 1: /* compact */
386 if (event_id > 30)
387 ctx->rflags |= LTT_RFLAG_EXTENDED;
388 break;
389 case 2: /* large */
390 if (event_id > 65534)
391 ctx->rflags |= LTT_RFLAG_EXTENDED;
392 break;
393 default:
394 WARN_ON_ONCE(1);
395 }
396
1c25284c
MD
397 ret = lib_ring_buffer_reserve(&client_config, ctx);
398 if (ret)
399 goto put;
4e1f08f4
MD
400 ltt_write_event_header(&client_config, ctx, event_id);
401 return 0;
1c25284c
MD
402put:
403 lib_ring_buffer_put_cpu(&client_config);
404 return ret;
ad1c05e1
MD
405}
406
c099397a 407static
1c25284c
MD
408void ltt_event_commit(struct lib_ring_buffer_ctx *ctx)
409{
410 lib_ring_buffer_commit(&client_config, ctx);
411 lib_ring_buffer_put_cpu(&client_config);
412}
413
c099397a 414static
e763dbf5
MD
415void ltt_event_write(struct lib_ring_buffer_ctx *ctx, const void *src,
416 size_t len)
417{
418 lib_ring_buffer_write(&client_config, ctx, src, len);
419}
1c25284c 420
c099397a
MD
421static
422wait_queue_head_t *ltt_get_reader_wait_queue(struct ltt_channel *chan)
423{
424 return &chan->chan->read_wait;
425}
426
7514523f 427static struct ltt_transport ltt_relay_transport = {
3d084699 428 .name = "relay-" RING_BUFFER_MODE_TEMPLATE_STRING,
7514523f
MD
429 .owner = THIS_MODULE,
430 .ops = {
1c25284c
MD
431 .channel_create = _channel_create,
432 .channel_destroy = ltt_channel_destroy,
ad1c05e1
MD
433 .buffer_read_open = ltt_buffer_read_open,
434 .buffer_read_close = ltt_buffer_read_close,
1c25284c
MD
435 .event_reserve = ltt_event_reserve,
436 .event_commit = ltt_event_commit,
e763dbf5 437 .event_write = ltt_event_write,
1ec3f75a 438 .packet_avail_size = NULL, /* Would be racy anyway */
c099397a 439 .get_reader_wait_queue = ltt_get_reader_wait_queue,
7514523f
MD
440 },
441};
442
3d084699 443static int __init ltt_ring_buffer_client_init(void)
7514523f 444{
a509e133
MD
445 /*
446 * This vmalloc sync all also takes care of the lib ring buffer
447 * vmalloc'd module pages when it is built as a module into LTTng.
448 */
6d2a620c 449 wrapper_vmalloc_sync_all();
7514523f
MD
450 printk(KERN_INFO "LTT : ltt ring buffer client init\n");
451 ltt_transport_register(&ltt_relay_transport);
452 return 0;
453}
454
1c25284c
MD
455module_init(ltt_ring_buffer_client_init);
456
3d084699 457static void __exit ltt_ring_buffer_client_exit(void)
7514523f
MD
458{
459 printk(KERN_INFO "LTT : ltt ring buffer client exit\n");
460 ltt_transport_unregister(&ltt_relay_transport);
461}
462
1c25284c
MD
463module_exit(ltt_ring_buffer_client_exit);
464
7514523f
MD
465MODULE_LICENSE("GPL and additional rights");
466MODULE_AUTHOR("Mathieu Desnoyers");
3d084699
MD
467MODULE_DESCRIPTION("LTTng ring buffer " RING_BUFFER_MODE_TEMPLATE_STRING
468 " client");
This page took 0.045014 seconds and 4 git commands to generate.