Update hardcoded loglevel
[lttng-ust.git] / libringbuffer / ring_buffer_backend.c
CommitLineData
852c2936
MD
1/*
2 * ring_buffer_backend.c
3 *
4 * Copyright (C) 2005-2010 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
5 *
6 * Dual LGPL v2.1/GPL v2 license.
7 */
8
14641deb
MD
9#include <urcu/arch.h>
10
4318ae1b 11#include <lttng/ringbuffer-config.h>
2fed87ae 12#include "vatomic.h"
4931a13e
MD
13#include "backend.h"
14#include "frontend.h"
a6352fd4 15#include "smp.h"
431d5cf0 16#include "shm.h"
852c2936
MD
17
18/**
19 * lib_ring_buffer_backend_allocate - allocate a channel buffer
20 * @config: ring buffer instance configuration
21 * @buf: the buffer struct
22 * @size: total size of the buffer
23 * @num_subbuf: number of subbuffers
24 * @extra_reader_sb: need extra subbuffer for reader
25 */
26static
4cfec15c
MD
27int lib_ring_buffer_backend_allocate(const struct lttng_ust_lib_ring_buffer_config *config,
28 struct lttng_ust_lib_ring_buffer_backend *bufb,
852c2936 29 size_t size, size_t num_subbuf,
a6352fd4 30 int extra_reader_sb,
38fae1d3 31 struct lttng_ust_shm_handle *handle,
1d498196 32 struct shm_object *shmobj)
852c2936 33{
1d498196 34 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
852c2936
MD
35 unsigned long subbuf_size, mmap_offset = 0;
36 unsigned long num_subbuf_alloc;
852c2936
MD
37 unsigned long i;
38
852c2936
MD
39 subbuf_size = chanb->subbuf_size;
40 num_subbuf_alloc = num_subbuf;
41
a6352fd4 42 if (extra_reader_sb)
852c2936 43 num_subbuf_alloc++;
852c2936 44
4cfec15c 45 align_shm(shmobj, __alignof__(struct lttng_ust_lib_ring_buffer_backend_pages_shmp));
1d498196 46 set_shmp(bufb->array, zalloc_shm(shmobj,
4cfec15c 47 sizeof(struct lttng_ust_lib_ring_buffer_backend_pages_shmp) * num_subbuf_alloc));
b5a3dfa5 48 if (caa_unlikely(!shmp(handle, bufb->array)))
852c2936
MD
49 goto array_error;
50
431d5cf0
MD
51 /*
52 * This is the largest element (the buffer pages) which needs to
53 * be aligned on PAGE_SIZE.
54 */
1d498196
MD
55 align_shm(shmobj, PAGE_SIZE);
56 set_shmp(bufb->memory_map, zalloc_shm(shmobj,
a6352fd4 57 subbuf_size * num_subbuf_alloc));
b5a3dfa5 58 if (caa_unlikely(!shmp(handle, bufb->memory_map)))
a6352fd4 59 goto memory_map_error;
852c2936
MD
60
61 /* Allocate backend pages array elements */
62 for (i = 0; i < num_subbuf_alloc; i++) {
4cfec15c 63 align_shm(shmobj, __alignof__(struct lttng_ust_lib_ring_buffer_backend_pages));
aead2025 64 set_shmp(shmp_index(handle, bufb->array, i)->shmp,
1d498196 65 zalloc_shm(shmobj,
4cfec15c 66 sizeof(struct lttng_ust_lib_ring_buffer_backend_pages)));
4746ae29 67 if (!shmp(handle, shmp_index(handle, bufb->array, i)->shmp))
852c2936
MD
68 goto free_array;
69 }
70
71 /* Allocate write-side subbuffer table */
4cfec15c 72 align_shm(shmobj, __alignof__(struct lttng_ust_lib_ring_buffer_backend_subbuffer));
1d498196 73 set_shmp(bufb->buf_wsb, zalloc_shm(shmobj,
4cfec15c 74 sizeof(struct lttng_ust_lib_ring_buffer_backend_subbuffer)
1d498196 75 * num_subbuf));
b5a3dfa5 76 if (caa_unlikely(!shmp(handle, bufb->buf_wsb)))
852c2936
MD
77 goto free_array;
78
79 for (i = 0; i < num_subbuf; i++)
4746ae29 80 shmp_index(handle, bufb->buf_wsb, i)->id = subbuffer_id(config, 0, 1, i);
852c2936
MD
81
82 /* Assign read-side subbuffer table */
83 if (extra_reader_sb)
84 bufb->buf_rsb.id = subbuffer_id(config, 0, 1,
85 num_subbuf_alloc - 1);
86 else
87 bufb->buf_rsb.id = subbuffer_id(config, 0, 1, 0);
88
89 /* Assign pages to page index */
90 for (i = 0; i < num_subbuf_alloc; i++) {
1d498196
MD
91 struct shm_ref ref;
92
93 ref.index = bufb->memory_map._ref.index;
94 ref.offset = bufb->memory_map._ref.offset;
95 ref.offset += i * subbuf_size;
96
4746ae29 97 set_shmp(shmp(handle, shmp_index(handle, bufb->array, i)->shmp)->p,
1d498196 98 ref);
852c2936 99 if (config->output == RING_BUFFER_MMAP) {
4746ae29 100 shmp(handle, shmp_index(handle, bufb->array, i)->shmp)->mmap_offset = mmap_offset;
852c2936
MD
101 mmap_offset += subbuf_size;
102 }
103 }
104
852c2936
MD
105 return 0;
106
107free_array:
a6352fd4
MD
108 /* bufb->array[i] will be freed by shm teardown */
109memory_map_error:
110 /* bufb->array will be freed by shm teardown */
852c2936 111array_error:
852c2936
MD
112 return -ENOMEM;
113}
114
4cfec15c 115int lib_ring_buffer_backend_create(struct lttng_ust_lib_ring_buffer_backend *bufb,
a6352fd4 116 struct channel_backend *chanb, int cpu,
38fae1d3 117 struct lttng_ust_shm_handle *handle,
1d498196 118 struct shm_object *shmobj)
852c2936 119{
4cfec15c 120 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
852c2936 121
1d498196 122 set_shmp(bufb->chan, handle->chan._ref);
852c2936
MD
123 bufb->cpu = cpu;
124
125 return lib_ring_buffer_backend_allocate(config, bufb, chanb->buf_size,
126 chanb->num_subbuf,
a6352fd4 127 chanb->extra_reader_sb,
1d498196 128 handle, shmobj);
852c2936
MD
129}
130
4cfec15c 131void lib_ring_buffer_backend_reset(struct lttng_ust_lib_ring_buffer_backend *bufb,
38fae1d3 132 struct lttng_ust_shm_handle *handle)
852c2936 133{
1d498196 134 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
4cfec15c 135 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
852c2936
MD
136 unsigned long num_subbuf_alloc;
137 unsigned int i;
138
139 num_subbuf_alloc = chanb->num_subbuf;
140 if (chanb->extra_reader_sb)
141 num_subbuf_alloc++;
142
143 for (i = 0; i < chanb->num_subbuf; i++)
4746ae29 144 shmp_index(handle, bufb->buf_wsb, i)->id = subbuffer_id(config, 0, 1, i);
852c2936
MD
145 if (chanb->extra_reader_sb)
146 bufb->buf_rsb.id = subbuffer_id(config, 0, 1,
147 num_subbuf_alloc - 1);
148 else
149 bufb->buf_rsb.id = subbuffer_id(config, 0, 1, 0);
150
151 for (i = 0; i < num_subbuf_alloc; i++) {
152 /* Don't reset mmap_offset */
4746ae29
MD
153 v_set(config, &shmp(handle, shmp_index(handle, bufb->array, i)->shmp)->records_commit, 0);
154 v_set(config, &shmp(handle, shmp_index(handle, bufb->array, i)->shmp)->records_unread, 0);
155 shmp(handle, shmp_index(handle, bufb->array, i)->shmp)->data_size = 0;
852c2936
MD
156 /* Don't reset backend page and virt addresses */
157 }
158 /* Don't reset num_pages_per_subbuf, cpu, allocated */
159 v_set(config, &bufb->records_read, 0);
160}
161
162/*
163 * The frontend is responsible for also calling ring_buffer_backend_reset for
164 * each buffer when calling channel_backend_reset.
165 */
166void channel_backend_reset(struct channel_backend *chanb)
167{
14641deb 168 struct channel *chan = caa_container_of(chanb, struct channel, backend);
4cfec15c 169 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
852c2936
MD
170
171 /*
172 * Don't reset buf_size, subbuf_size, subbuf_size_order,
173 * num_subbuf_order, buf_size_order, extra_reader_sb, num_subbuf,
174 * priv, notifiers, config, cpumask and name.
175 */
176 chanb->start_tsc = config->cb.ring_buffer_clock_read(chan);
177}
178
852c2936
MD
179/**
180 * channel_backend_init - initialize a channel backend
181 * @chanb: channel backend
182 * @name: channel name
183 * @config: client ring buffer configuration
852c2936
MD
184 * @parent: dentry of parent directory, %NULL for root directory
185 * @subbuf_size: size of sub-buffers (> PAGE_SIZE, power of 2)
186 * @num_subbuf: number of sub-buffers (power of 2)
38fae1d3 187 * @lttng_ust_shm_handle: shared memory handle
852c2936
MD
188 *
189 * Returns channel pointer if successful, %NULL otherwise.
190 *
191 * Creates per-cpu channel buffers using the sizes and attributes
192 * specified. The created channel buffer files will be named
193 * name_0...name_N-1. File permissions will be %S_IRUSR.
194 *
195 * Called with CPU hotplug disabled.
196 */
197int channel_backend_init(struct channel_backend *chanb,
198 const char *name,
4cfec15c 199 const struct lttng_ust_lib_ring_buffer_config *config,
a3f61e7f 200 size_t subbuf_size, size_t num_subbuf,
38fae1d3 201 struct lttng_ust_shm_handle *handle)
852c2936 202{
14641deb 203 struct channel *chan = caa_container_of(chanb, struct channel, backend);
852c2936
MD
204 unsigned int i;
205 int ret;
6c1f7d8b 206 size_t shmsize = 0, num_subbuf_alloc;
852c2936
MD
207
208 if (!name)
209 return -EPERM;
210
211 if (!(subbuf_size && num_subbuf))
212 return -EPERM;
213
214 /* Check that the subbuffer size is larger than a page. */
215 if (subbuf_size < PAGE_SIZE)
216 return -EINVAL;
217
218 /*
219 * Make sure the number of subbuffers and subbuffer size are power of 2.
220 */
221 CHAN_WARN_ON(chanb, hweight32(subbuf_size) != 1);
222 CHAN_WARN_ON(chanb, hweight32(num_subbuf) != 1);
223
224 ret = subbuffer_id_check_index(config, num_subbuf);
225 if (ret)
226 return ret;
227
852c2936
MD
228 chanb->buf_size = num_subbuf * subbuf_size;
229 chanb->subbuf_size = subbuf_size;
230 chanb->buf_size_order = get_count_order(chanb->buf_size);
231 chanb->subbuf_size_order = get_count_order(subbuf_size);
232 chanb->num_subbuf_order = get_count_order(num_subbuf);
233 chanb->extra_reader_sb =
234 (config->mode == RING_BUFFER_OVERWRITE) ? 1 : 0;
235 chanb->num_subbuf = num_subbuf;
a6352fd4
MD
236 strncpy(chanb->name, name, NAME_MAX);
237 chanb->name[NAME_MAX - 1] = '\0';
193183fb 238 memcpy(&chanb->config, config, sizeof(*config));
852c2936 239
1d498196 240 /* Per-cpu buffer size: control (prior to backend) */
4cfec15c
MD
241 shmsize = offset_align(shmsize, __alignof__(struct lttng_ust_lib_ring_buffer));
242 shmsize += sizeof(struct lttng_ust_lib_ring_buffer);
1d498196
MD
243
244 /* Per-cpu buffer size: backend */
245 /* num_subbuf + 1 is the worse case */
246 num_subbuf_alloc = num_subbuf + 1;
4cfec15c
MD
247 shmsize += offset_align(shmsize, __alignof__(struct lttng_ust_lib_ring_buffer_backend_pages_shmp));
248 shmsize += sizeof(struct lttng_ust_lib_ring_buffer_backend_pages_shmp) * num_subbuf_alloc;
6c1f7d8b 249 shmsize += offset_align(shmsize, PAGE_SIZE);
1d498196 250 shmsize += subbuf_size * num_subbuf_alloc;
4cfec15c
MD
251 shmsize += offset_align(shmsize, __alignof__(struct lttng_ust_lib_ring_buffer_backend_pages));
252 shmsize += sizeof(struct lttng_ust_lib_ring_buffer_backend_pages) * num_subbuf_alloc;
253 shmsize += offset_align(shmsize, __alignof__(struct lttng_ust_lib_ring_buffer_backend_subbuffer));
254 shmsize += sizeof(struct lttng_ust_lib_ring_buffer_backend_subbuffer) * num_subbuf;
1d498196
MD
255 /* Per-cpu buffer size: control (after backend) */
256 shmsize += offset_align(shmsize, __alignof__(struct commit_counters_hot));
257 shmsize += sizeof(struct commit_counters_hot) * num_subbuf;
258 shmsize += offset_align(shmsize, __alignof__(struct commit_counters_cold));
259 shmsize += sizeof(struct commit_counters_cold) * num_subbuf;
260
852c2936 261 if (config->alloc == RING_BUFFER_ALLOC_PER_CPU) {
4cfec15c 262 struct lttng_ust_lib_ring_buffer *buf;
852c2936 263 /*
a6352fd4 264 * We need to allocate for all possible cpus.
852c2936 265 */
852c2936 266 for_each_possible_cpu(i) {
1d498196
MD
267 struct shm_object *shmobj;
268
269 shmobj = shm_object_table_append(handle->table, shmsize);
afdf9825
MD
270 if (!shmobj)
271 goto end;
4cfec15c
MD
272 align_shm(shmobj, __alignof__(struct lttng_ust_lib_ring_buffer));
273 set_shmp(chanb->buf[i].shmp, zalloc_shm(shmobj, sizeof(struct lttng_ust_lib_ring_buffer)));
1d498196
MD
274 buf = shmp(handle, chanb->buf[i].shmp);
275 if (!buf)
276 goto end;
5d61a504 277 set_shmp(buf->self, chanb->buf[i].shmp._ref);
1d498196
MD
278 ret = lib_ring_buffer_create(buf, chanb, i,
279 handle, shmobj);
852c2936
MD
280 if (ret)
281 goto free_bufs; /* cpu hotplug locked */
282 }
852c2936 283 } else {
1d498196 284 struct shm_object *shmobj;
4cfec15c 285 struct lttng_ust_lib_ring_buffer *buf;
a6352fd4 286
1d498196 287 shmobj = shm_object_table_append(handle->table, shmsize);
afdf9825
MD
288 if (!shmobj)
289 goto end;
4cfec15c
MD
290 align_shm(shmobj, __alignof__(struct lttng_ust_lib_ring_buffer));
291 set_shmp(chanb->buf[0].shmp, zalloc_shm(shmobj, sizeof(struct lttng_ust_lib_ring_buffer)));
1d498196 292 buf = shmp(handle, chanb->buf[0].shmp);
a6352fd4
MD
293 if (!buf)
294 goto end;
cb14bae9 295 set_shmp(buf->self, chanb->buf[0].shmp._ref);
1d498196
MD
296 ret = lib_ring_buffer_create(buf, chanb, -1,
297 handle, shmobj);
852c2936
MD
298 if (ret)
299 goto free_bufs;
300 }
301 chanb->start_tsc = config->cb.ring_buffer_clock_read(chan);
302
303 return 0;
304
305free_bufs:
a6352fd4
MD
306 /* We only free the buffer data upon shm teardown */
307end:
852c2936
MD
308 return -ENOMEM;
309}
310
852c2936
MD
311/**
312 * channel_backend_free - destroy the channel
313 * @chan: the channel
314 *
315 * Destroy all channel buffers and frees the channel.
316 */
1d498196 317void channel_backend_free(struct channel_backend *chanb,
38fae1d3 318 struct lttng_ust_shm_handle *handle)
852c2936 319{
45e9e699 320 /* SHM teardown takes care of everything */
852c2936
MD
321}
322
852c2936
MD
323/**
324 * lib_ring_buffer_read - read data from ring_buffer_buffer.
325 * @bufb : buffer backend
326 * @offset : offset within the buffer
327 * @dest : destination address
328 * @len : length to copy to destination
329 *
330 * Should be protected by get_subbuf/put_subbuf.
331 * Returns the length copied.
332 */
4cfec15c 333size_t lib_ring_buffer_read(struct lttng_ust_lib_ring_buffer_backend *bufb, size_t offset,
38fae1d3 334 void *dest, size_t len, struct lttng_ust_shm_handle *handle)
852c2936 335{
1d498196 336 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
4cfec15c 337 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
a6352fd4 338 ssize_t orig_len;
4cfec15c 339 struct lttng_ust_lib_ring_buffer_backend_pages_shmp *rpages;
852c2936
MD
340 unsigned long sb_bindex, id;
341
342 orig_len = len;
343 offset &= chanb->buf_size - 1;
a6352fd4 344
b5a3dfa5 345 if (caa_unlikely(!len))
852c2936 346 return 0;
a6352fd4
MD
347 id = bufb->buf_rsb.id;
348 sb_bindex = subbuffer_id_get_index(config, id);
4746ae29 349 rpages = shmp_index(handle, bufb->array, sb_bindex);
a6352fd4
MD
350 /*
351 * Underlying layer should never ask for reads across
352 * subbuffers.
353 */
354 CHAN_WARN_ON(chanb, offset >= chanb->buf_size);
355 CHAN_WARN_ON(chanb, config->mode == RING_BUFFER_OVERWRITE
356 && subbuffer_id_is_noref(config, id));
aead2025 357 memcpy(dest, shmp_index(handle, shmp(handle, rpages->shmp)->p, offset & (chanb->subbuf_size - 1)), len);
852c2936
MD
358 return orig_len;
359}
852c2936 360
852c2936
MD
361/**
362 * lib_ring_buffer_read_cstr - read a C-style string from ring_buffer.
363 * @bufb : buffer backend
364 * @offset : offset within the buffer
365 * @dest : destination address
366 * @len : destination's length
367 *
368 * return string's length
369 * Should be protected by get_subbuf/put_subbuf.
370 */
4cfec15c 371int lib_ring_buffer_read_cstr(struct lttng_ust_lib_ring_buffer_backend *bufb, size_t offset,
38fae1d3 372 void *dest, size_t len, struct lttng_ust_shm_handle *handle)
852c2936 373{
1d498196 374 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
4cfec15c 375 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
a6352fd4 376 ssize_t string_len, orig_offset;
852c2936 377 char *str;
4cfec15c 378 struct lttng_ust_lib_ring_buffer_backend_pages_shmp *rpages;
852c2936
MD
379 unsigned long sb_bindex, id;
380
381 offset &= chanb->buf_size - 1;
852c2936 382 orig_offset = offset;
852c2936
MD
383 id = bufb->buf_rsb.id;
384 sb_bindex = subbuffer_id_get_index(config, id);
4746ae29 385 rpages = shmp_index(handle, bufb->array, sb_bindex);
a6352fd4
MD
386 /*
387 * Underlying layer should never ask for reads across
388 * subbuffers.
389 */
390 CHAN_WARN_ON(chanb, offset >= chanb->buf_size);
852c2936
MD
391 CHAN_WARN_ON(chanb, config->mode == RING_BUFFER_OVERWRITE
392 && subbuffer_id_is_noref(config, id));
aead2025 393 str = shmp_index(handle, shmp(handle, rpages->shmp)->p, offset & (chanb->subbuf_size - 1));
a6352fd4
MD
394 string_len = strnlen(str, len);
395 if (dest && len) {
396 memcpy(dest, str, string_len);
397 ((char *)dest)[0] = 0;
398 }
399 return offset - orig_offset;
852c2936 400}
852c2936
MD
401
402/**
403 * lib_ring_buffer_read_offset_address - get address of a buffer location
404 * @bufb : buffer backend
405 * @offset : offset within the buffer.
406 *
407 * Return the address where a given offset is located (for read).
408 * Should be used to get the current subbuffer header pointer. Given we know
409 * it's never on a page boundary, it's safe to write directly to this address,
410 * as long as the write is never bigger than a page size.
411 */
4cfec15c 412void *lib_ring_buffer_read_offset_address(struct lttng_ust_lib_ring_buffer_backend *bufb,
1d498196 413 size_t offset,
38fae1d3 414 struct lttng_ust_shm_handle *handle)
852c2936 415{
4cfec15c 416 struct lttng_ust_lib_ring_buffer_backend_pages_shmp *rpages;
1d498196 417 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
4cfec15c 418 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
852c2936
MD
419 unsigned long sb_bindex, id;
420
421 offset &= chanb->buf_size - 1;
852c2936
MD
422 id = bufb->buf_rsb.id;
423 sb_bindex = subbuffer_id_get_index(config, id);
4746ae29 424 rpages = shmp_index(handle, bufb->array, sb_bindex);
852c2936
MD
425 CHAN_WARN_ON(chanb, config->mode == RING_BUFFER_OVERWRITE
426 && subbuffer_id_is_noref(config, id));
aead2025 427 return shmp_index(handle, shmp(handle, rpages->shmp)->p, offset & (chanb->subbuf_size - 1));
852c2936 428}
852c2936
MD
429
430/**
431 * lib_ring_buffer_offset_address - get address of a location within the buffer
432 * @bufb : buffer backend
433 * @offset : offset within the buffer.
434 *
435 * Return the address where a given offset is located.
436 * Should be used to get the current subbuffer header pointer. Given we know
437 * it's always at the beginning of a page, it's safe to write directly to this
438 * address, as long as the write is never bigger than a page size.
439 */
4cfec15c 440void *lib_ring_buffer_offset_address(struct lttng_ust_lib_ring_buffer_backend *bufb,
1d498196 441 size_t offset,
38fae1d3 442 struct lttng_ust_shm_handle *handle)
852c2936 443{
a6352fd4 444 size_t sbidx;
4cfec15c 445 struct lttng_ust_lib_ring_buffer_backend_pages_shmp *rpages;
1d498196 446 struct channel_backend *chanb = &shmp(handle, bufb->chan)->backend;
4cfec15c 447 const struct lttng_ust_lib_ring_buffer_config *config = &chanb->config;
852c2936
MD
448 unsigned long sb_bindex, id;
449
450 offset &= chanb->buf_size - 1;
451 sbidx = offset >> chanb->subbuf_size_order;
4746ae29 452 id = shmp_index(handle, bufb->buf_wsb, sbidx)->id;
852c2936 453 sb_bindex = subbuffer_id_get_index(config, id);
4746ae29 454 rpages = shmp_index(handle, bufb->array, sb_bindex);
852c2936
MD
455 CHAN_WARN_ON(chanb, config->mode == RING_BUFFER_OVERWRITE
456 && subbuffer_id_is_noref(config, id));
aead2025 457 return shmp_index(handle, shmp(handle, rpages->shmp)->p, offset & (chanb->subbuf_size - 1));
852c2936 458}
This page took 0.050139 seconds and 4 git commands to generate.