LTTng-UST only requires that you link your application or tracepoint
provider package with `-llttng-ust-common` if you define
`_LGPL_SOURCE` before you include, directly or indirectly,
`<lttng/tracepoint.h>`.
The `_LGPL_SOURCE` definition is specific to the EfficiOS/LTTng
projects.
Because defining `_LGPL_SOURCE` is not considered the typical scenario,
remove instructions to link with `-llttng-ust-common` throughout the
manual pages, except in synopses, to make such instructions more
readable/light.
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
Change-Id: I460a2f746d5e2904660a11b3151d0d01776361db
#define *lttng_ust_tracepoint*('prov_name', 't_name', ...)
#define *lttng_ust_tracepoint_enabled*('prov_name', 't_name')
#define *lttng_ust_tracepoint*('prov_name', 't_name', ...)
#define *lttng_ust_tracepoint_enabled*('prov_name', 't_name')
-Link with `-llttng-ust -llttng-ust-common -ldl`, following this man page.
+Link with, following this manual page:
+
+* `-llttng-ust -ldl`
+* If you define `_LGPL_SOURCE` before including
+ `<lttng/tracepoint.h>` (directly or indirectly): `-llttng-ust-common`
provider's API changes).
Then, link your application with this object file (or with the static
provider's API changes).
Then, link your application with this object file (or with the static
-library containing it) and with `liblttng-ust`, `liblttng-ust-common`,
-and `libdl` (`libc` on a BSD system):
+library containing it) and with `liblttng-ust` and `libdl` (`libc` on a
+BSD system):
-$ cc -o app tp.o app.o -llttng-ust -llttng-ust-common -ldl
+$ cc -o app tp.o app.o -llttng-ust -ldl
-$ cc -shared -Wl,--no-as-needed -o tp.so tp.o -llttng-ust \
- -llttng-ust-common
+$ cc -shared -Wl,--no-as-needed -o tp.so tp.o -llttng-ust
----
This tracepoint provider shared object isn't linked with the user
----
This tracepoint provider shared object isn't linked with the user
----
$ cc -c -I. tp.c
$ cc -c app.c
----
$ cc -c -I. tp.c
$ cc -c app.c
-$ cc -o app tp.o app.o -llttng-ust -llttng-ust-common -ldl
+$ cc -o app tp.o app.o -llttng-ust -ldl
----
Using the man:lttng(1) tool, create an LTTng tracing session, enable
----
Using the man:lttng(1) tool, create an LTTng tracing session, enable
#define *lttng_ust_tracef*('fmt', ...)
#define *lttng_ust_vtracef*('fmt', 'ap')
#define *lttng_ust_tracef*('fmt', ...)
#define *lttng_ust_vtracef*('fmt', 'ap')
-Link with `-llttng-ust -llttng-ust-common`.
+Link with:
+
+* `-llttng-ust`
+* If you define `_LGPL_SOURCE` before including
+ `<lttng/tracef.h>` (directly or indirectly): `-llttng-ust-common`
#define *lttng_ust_tracelog*('level', 'fmt', ...)
#define *lttng_ust_vtracelog*('level', 'fmt', 'ap')
#define *lttng_ust_tracelog*('level', 'fmt', ...)
#define *lttng_ust_vtracelog*('level', 'fmt', 'ap')
-Link with `-llttng-ust -llttng-ust-common`.
+* `-llttng-ust`
+* If you define `_LGPL_SOURCE` before including
+ `<lttng/tracelog.h>` (directly or indirectly): `-llttng-ust-common`