-The +{macro-name}()+ and +v{macro-name}()+ utility macros were
+:macro-name: lttng_ust_{macro-suffix}
+:vmacro-name: lttng_ust_v{macro-suffix}
+
+The +{macro-name}()+ and +{vmacro-name}()+ utility macros were
developed to make user space tracing super simple, albeit with notable
disadvantages compared to custom, full-fledged tracepoint providers:
developed to make user space tracing super simple, albeit with notable
disadvantages compared to custom, full-fledged tracepoint providers:
macro using your own format. This also means that you cannot use
filtering using a custom expression at run time because there are no
isolated fields.
macro using your own format. This also means that you cannot use
filtering using a custom expression at run time because there are no
isolated fields.
library's man:vasprintf(3) function in the background to format the
strings at run time, their expected performance is lower than using
custom tracepoint providers with typed fields, which do not require
library's man:vasprintf(3) function in the background to format the
strings at run time, their expected performance is lower than using
custom tracepoint providers with typed fields, which do not require
prototyping and debugging, but should not be considered for any
permanent/serious application instrumentation.
prototyping and debugging, but should not be considered for any
permanent/serious application instrumentation.