Skip to content

Commit 590a512

Browse files
Merge branch 'update-readme-humble' into 'humble'
Update LTTng version for docs links in README See merge request ros-tracing/ros2_tracing!295
2 parents 9118437 + 267bfea commit 590a512

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ If LTTng is not found during build, or if the [`TRACETOOLS_DISABLED` option is e
4949

5050
To enable tracing:
5151

52-
1. Install [LTTng](https://lttng.org/docs/v2.11/) (`>=2.11.1`) with the Python bindings to control tracing and read traces:
52+
1. Install [LTTng](https://lttng.org/docs/v2.13/) (`>=2.11.1`) with the Python bindings to control tracing and read traces:
5353
```
5454
$ sudo apt-get update
5555
$ sudo apt-get install lttng-tools liblttng-ust-dev
@@ -60,7 +60,7 @@ To enable tracing:
6060
```
6161
$ sudo apt-get install lttng-modules-dkms
6262
```
63-
* For more information about LTTng, [see its documentation](https://lttng.org/docs/v2.11/).
63+
* For more information about LTTng, [see its documentation](https://lttng.org/docs/v2.13/).
6464
2. Build:
6565
* If you've already built ROS 2 from source before installing LTTng, you will need to re-build at least up to `tracetools`:
6666
```
@@ -101,7 +101,7 @@ The tracing directory can be configured using command/launch action parameters,
101101
* Use `$ROS_TRACE_DIR` if `ROS_TRACE_DIR` is set and not empty.
102102
* Otherwise, use `$ROS_HOME/tracing`, using `~/.ros` for `ROS_HOME` if not set or if empty.
103103
104-
Additionally, **if you're using kernel tracing with a non-root user, make sure that the [`tracing` group exists and that your user is added to it](https://lttng.org/docs/v2.11/#doc-tracing-group)**.
104+
Additionally, **if you're using kernel tracing with a non-root user, make sure that the [`tracing` group exists and that your user is added to it](https://lttng.org/docs/v2.13/#doc-tracing-group)**.
105105
106106
```
107107
# Create group if it doesn't exist
@@ -134,7 +134,7 @@ This way, tracing automatically starts when launching the launch file and ends w
134134
$ ros2 launch tracetools_launch example.launch.py
135135
```
136136
137-
The `Trace` action will also set the `LD_PRELOAD` environment to preload [LTTng's userspace tracing helper(s)](https://lttng.org/docs/#doc-prebuilt-ust-helpers) if the corresponding event(s) are enabled.
137+
The `Trace` action will also set the `LD_PRELOAD` environment to preload [LTTng's userspace tracing helper(s)](https://lttng.org/docs/v2.13/#doc-prebuilt-ust-helpers) if the corresponding event(s) are enabled.
138138
For more information, see [this example launch file](./tracetools_launch/launch/example.launch.py) and the [`Trace` action](./tracetools_launch/tracetools_launch/action.py).
139139
140140
You must [install the kernel tracer](#building) if you want to enable kernel events (`events_kernel` in Python, `events-kernel` in XML or YAML).
@@ -156,9 +156,9 @@ It is a low-overhead tracer with many important real-time compatible features:
156156
157157
However, some settings need to be tuned for it to be fully real-time safe and for performance to be optimal for your use-case:
158158
159-
* timers[^rt-1]: use [read timer](https://lttng.org/docs/v2.11/#doc-channel-read-timer) to avoid a write(2) call
159+
* timers[^rt-1]: use [read timer](https://lttng.org/docs/v2.13/#doc-channel-read-timer) to avoid a write(2) call
160160
* sub-buffer[^rt-1] count and size:
161-
* see [documentation](https://lttng.org/docs/v2.11/#doc-channel-subbuf-size-vs-subbuf-count) for sub-buffer count and size tuning tips based on your use-case
161+
* see [documentation](https://lttng.org/docs/v2.13/#doc-channel-subbuf-size-vs-subbuf-count) for sub-buffer count and size tuning tips based on your use-case
162162
* minimize sub-buffer count to minimize sub-buffer switching overhead
163163
* one-time memory allocation/lock/syscall per thread:
164164
* usually done the first time a tracepoint is executed within a thread for URCU thread registration, but registration can be manually performed to force it to be done during your application's initialization
@@ -168,7 +168,7 @@ However, some settings need to be tuned for it to be fully real-time safe and fo
168168
169169
For further reading:
170170
171-
* [LTTng documentation](https://lttng.org/docs/v2.11/)
171+
* [LTTng documentation](https://lttng.org/docs/v2.13/)
172172
* [Combined Tracing of the Kernel and Applications with LTTng](http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.641.1965&rep=rep1&type=pdf#page=87): LTTng-UST architecture and design goals (section 3)
173173
* [Survey and Analysis of Kernel and Userspace Tracers on Linux: Design, Implementation, and Overhead](https://dl.acm.org/doi/abs/10.1145/3158644): LTTng-UST overhead and design compared to other kernel and userspace tracers (table 6: average latency overhead per tracepoint of 158 ns)
174174

0 commit comments

Comments
 (0)