DPDK  24.07.0
rte_trace_point.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(C) 2020 Marvell International Ltd.
3  */
4 
5 #ifndef _RTE_TRACE_POINT_H_
6 #define _RTE_TRACE_POINT_H_
7 
19 #ifdef __cplusplus
20 extern "C" {
21 #endif
22 
23 #include <stdbool.h>
24 #include <stdio.h>
25 
26 #include <rte_branch_prediction.h>
27 #include <rte_common.h>
28 #include <rte_compat.h>
29 #include <rte_cycles.h>
30 #include <rte_per_lcore.h>
31 #include <rte_stdatomic.h>
32 #include <rte_string_fns.h>
33 #include <rte_uuid.h>
34 
36 typedef RTE_ATOMIC(uint64_t) rte_trace_point_t;
37 
43 #define RTE_TRACE_POINT_ARGS
44 
46 #define __RTE_TRACE_POINT(_mode, _tp, _args, ...) \
47 extern rte_trace_point_t __##_tp; \
48 static __rte_always_inline void \
49 _tp _args \
50 { \
51  __rte_trace_point_emit_header_##_mode(&__##_tp); \
52  __VA_ARGS__ \
53 }
54 
79 #define RTE_TRACE_POINT(tp, args, ...) \
80  __RTE_TRACE_POINT(generic, tp, args, __VA_ARGS__)
81 
100 #define RTE_TRACE_POINT_FP(tp, args, ...) \
101  __RTE_TRACE_POINT(fp, tp, args, __VA_ARGS__)
102 
103 #ifdef __DOXYGEN__
104 
116 #define RTE_TRACE_POINT_REGISTER(trace, name)
117 
119 #define rte_trace_point_emit_u64(val)
120 
121 #define rte_trace_point_emit_i64(val)
122 
123 #define rte_trace_point_emit_u32(val)
124 
125 #define rte_trace_point_emit_i32(val)
126 
127 #define rte_trace_point_emit_u16(val)
128 
129 #define rte_trace_point_emit_i16(val)
130 
131 #define rte_trace_point_emit_u8(val)
132 
133 #define rte_trace_point_emit_i8(val)
134 
135 #define rte_trace_point_emit_int(val)
136 
137 #define rte_trace_point_emit_long(val)
138 
139 #define rte_trace_point_emit_size_t(val)
140 
141 #define rte_trace_point_emit_float(val)
142 
143 #define rte_trace_point_emit_double(val)
144 
145 #define rte_trace_point_emit_ptr(val)
146 
147 #define rte_trace_point_emit_string(val)
148 
157 #define rte_trace_point_emit_blob(val, len)
158 
159 #endif /* __DOXYGEN__ */
160 
162 #define __RTE_TRACE_EMIT_STRING_LEN_MAX 32
163 
164 #define __RTE_TRACE_EVENT_HEADER_SZ sizeof(uint64_t)
165 
167 #define RTE_TRACE_BLOB_LEN_MAX 64
168 
178 __rte_experimental
179 int rte_trace_point_enable(rte_trace_point_t *tp);
180 
190 __rte_experimental
191 int rte_trace_point_disable(rte_trace_point_t *tp);
192 
201 __rte_experimental
202 bool rte_trace_point_is_enabled(rte_trace_point_t *tp);
203 
212 __rte_experimental
213 rte_trace_point_t *rte_trace_point_lookup(const char *name);
214 
223 __rte_experimental
224 static __rte_always_inline bool
225 __rte_trace_point_fp_is_enabled(void)
226 {
227 #ifdef RTE_ENABLE_TRACE_FP
228  return true;
229 #else
230  return false;
231 #endif
232 }
233 
239 __rte_experimental
240 void __rte_trace_mem_per_thread_alloc(void);
241 
257 __rte_experimental
258 void __rte_trace_point_emit_field(size_t sz, const char *field,
259  const char *type);
260 
277 __rte_experimental
278 int __rte_trace_point_register(rte_trace_point_t *trace, const char *name,
279  void (*register_fn)(void));
280 
281 #ifndef __DOXYGEN__
282 
283 #ifndef _RTE_TRACE_POINT_REGISTER_H_
284 #ifdef ALLOW_EXPERIMENTAL_API
285 
286 #define __RTE_TRACE_EVENT_HEADER_ID_SHIFT (48)
287 
288 #define __RTE_TRACE_FIELD_SIZE_SHIFT 0
289 #define __RTE_TRACE_FIELD_SIZE_MASK (0xffffULL << __RTE_TRACE_FIELD_SIZE_SHIFT)
290 #define __RTE_TRACE_FIELD_ID_SHIFT (16)
291 #define __RTE_TRACE_FIELD_ID_MASK (0xffffULL << __RTE_TRACE_FIELD_ID_SHIFT)
292 #define __RTE_TRACE_FIELD_ENABLE_MASK (1ULL << 63)
293 #define __RTE_TRACE_FIELD_ENABLE_DISCARD (1ULL << 62)
294 
295 struct __rte_trace_stream_header {
296  uint32_t magic;
297  rte_uuid_t uuid;
298  uint32_t lcore_id;
299  char thread_name[__RTE_TRACE_EMIT_STRING_LEN_MAX];
300 } __rte_packed;
301 
302 struct __rte_trace_header {
303  uint32_t offset;
304  uint32_t len;
305  struct __rte_trace_stream_header stream_header;
306  uint8_t mem[];
307 };
308 
309 RTE_DECLARE_PER_LCORE(void *, trace_mem);
310 
311 static __rte_always_inline void *
312 __rte_trace_mem_get(uint64_t in)
313 {
314  struct __rte_trace_header *trace =
315  (struct __rte_trace_header *)(RTE_PER_LCORE(trace_mem));
316  const uint16_t sz = in & __RTE_TRACE_FIELD_SIZE_MASK;
317 
318  /* Trace memory is not initialized for this thread */
319  if (unlikely(trace == NULL)) {
320  __rte_trace_mem_per_thread_alloc();
321  trace = (struct __rte_trace_header *)(RTE_PER_LCORE(trace_mem));
322  if (unlikely(trace == NULL))
323  return NULL;
324  }
325  /* Check the wrap around case */
326  uint32_t offset = trace->offset;
327  if (unlikely((offset + sz) >= trace->len)) {
328  /* Disable the trace event if it in DISCARD mode */
329  if (unlikely(in & __RTE_TRACE_FIELD_ENABLE_DISCARD))
330  return NULL;
331 
332  offset = 0;
333  }
334  /* Align to event header size */
335  offset = RTE_ALIGN_CEIL(offset, __RTE_TRACE_EVENT_HEADER_SZ);
336  void *mem = RTE_PTR_ADD(&trace->mem[0], offset);
337  offset += sz;
338  trace->offset = offset;
339 
340  return mem;
341 }
342 
343 static __rte_always_inline void *
344 __rte_trace_point_emit_ev_header(void *mem, uint64_t in)
345 {
346  uint64_t val;
347 
348  /* Event header [63:0] = id [63:48] | timestamp [47:0] */
349  val = rte_get_tsc_cycles() &
350  ~(0xffffULL << __RTE_TRACE_EVENT_HEADER_ID_SHIFT);
351  val |= ((in & __RTE_TRACE_FIELD_ID_MASK) <<
352  (__RTE_TRACE_EVENT_HEADER_ID_SHIFT -
353  __RTE_TRACE_FIELD_ID_SHIFT));
354 
355  *(uint64_t *)mem = val;
356  return RTE_PTR_ADD(mem, __RTE_TRACE_EVENT_HEADER_SZ);
357 }
358 
359 #define __rte_trace_point_emit_header_generic(t) \
360 void *mem; \
361 do { \
362  const uint64_t val = rte_atomic_load_explicit(t, rte_memory_order_acquire); \
363  if (likely(!(val & __RTE_TRACE_FIELD_ENABLE_MASK))) \
364  return; \
365  mem = __rte_trace_mem_get(val); \
366  if (unlikely(mem == NULL)) \
367  return; \
368  mem = __rte_trace_point_emit_ev_header(mem, val); \
369 } while (0)
370 
371 #define __rte_trace_point_emit_header_fp(t) \
372  if (!__rte_trace_point_fp_is_enabled()) \
373  return; \
374  __rte_trace_point_emit_header_generic(t)
375 
376 #define __rte_trace_point_emit(in, type) \
377 do { \
378  memcpy(mem, &(in), sizeof(in)); \
379  mem = RTE_PTR_ADD(mem, sizeof(in)); \
380 } while (0)
381 
382 #define rte_trace_point_emit_string(in) \
383 do { \
384  if (unlikely(in == NULL)) \
385  return; \
386  rte_strscpy((char *)mem, in, __RTE_TRACE_EMIT_STRING_LEN_MAX); \
387  mem = RTE_PTR_ADD(mem, __RTE_TRACE_EMIT_STRING_LEN_MAX); \
388 } while (0)
389 
390 #define rte_trace_point_emit_blob(in, len) \
391 do { \
392  if (unlikely(in == NULL)) \
393  return; \
394  if (len > RTE_TRACE_BLOB_LEN_MAX) \
395  len = RTE_TRACE_BLOB_LEN_MAX; \
396  __rte_trace_point_emit(len, uint8_t); \
397  memcpy(mem, in, len); \
398  memset(RTE_PTR_ADD(mem, len), 0, RTE_TRACE_BLOB_LEN_MAX - len); \
399  mem = RTE_PTR_ADD(mem, RTE_TRACE_BLOB_LEN_MAX); \
400 } while (0)
401 
402 #else
403 
404 #define __rte_trace_point_emit_header_generic(t) RTE_SET_USED(t)
405 #define __rte_trace_point_emit_header_fp(t) RTE_SET_USED(t)
406 #define __rte_trace_point_emit(in, type) RTE_SET_USED(in)
407 #define rte_trace_point_emit_string(in) RTE_SET_USED(in)
408 #define rte_trace_point_emit_blob(in, len) \
409 do { \
410  RTE_SET_USED(in); \
411  RTE_SET_USED(len); \
412 } while (0)
413 
414 
415 #endif /* ALLOW_EXPERIMENTAL_API */
416 #endif /* _RTE_TRACE_POINT_REGISTER_H_ */
417 
418 #define rte_trace_point_emit_u64(in) __rte_trace_point_emit(in, uint64_t)
419 #define rte_trace_point_emit_i64(in) __rte_trace_point_emit(in, int64_t)
420 #define rte_trace_point_emit_u32(in) __rte_trace_point_emit(in, uint32_t)
421 #define rte_trace_point_emit_i32(in) __rte_trace_point_emit(in, int32_t)
422 #define rte_trace_point_emit_u16(in) __rte_trace_point_emit(in, uint16_t)
423 #define rte_trace_point_emit_i16(in) __rte_trace_point_emit(in, int16_t)
424 #define rte_trace_point_emit_u8(in) __rte_trace_point_emit(in, uint8_t)
425 #define rte_trace_point_emit_i8(in) __rte_trace_point_emit(in, int8_t)
426 #define rte_trace_point_emit_int(in) __rte_trace_point_emit(in, int32_t)
427 #define rte_trace_point_emit_long(in) __rte_trace_point_emit(in, long)
428 #define rte_trace_point_emit_size_t(in) __rte_trace_point_emit(in, size_t)
429 #define rte_trace_point_emit_float(in) __rte_trace_point_emit(in, float)
430 #define rte_trace_point_emit_double(in) __rte_trace_point_emit(in, double)
431 #define rte_trace_point_emit_ptr(in) __rte_trace_point_emit(in, uintptr_t)
432 
433 #endif /* __DOXYGEN__ */
434 
435 #ifdef __cplusplus
436 }
437 #endif
438 
439 #endif /* _RTE_TRACE_POINT_H_ */
#define RTE_DECLARE_PER_LCORE(type, name)
Definition: rte_per_lcore.h:43
#define __rte_always_inline
Definition: rte_common.h:370
#define RTE_ALIGN_CEIL(val, align)
Definition: rte_common.h:466
__rte_experimental int rte_trace_point_disable(rte_trace_point_t *tp)
#define __rte_packed
Definition: rte_common.h:108
__rte_experimental rte_trace_point_t * rte_trace_point_lookup(const char *name)
#define RTE_PTR_ADD(ptr, x)
Definition: rte_common.h:410
#define unlikely(x)
unsigned char rte_uuid_t[16]
Definition: rte_uuid.h:24
static uint64_t rte_get_tsc_cycles(void)
__rte_experimental int rte_trace_point_enable(rte_trace_point_t *tp)
#define RTE_PER_LCORE(name)
Definition: rte_per_lcore.h:50
__rte_experimental bool rte_trace_point_is_enabled(rte_trace_point_t *tp)