projects / lttng-docs.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
2.8-2.12: "lost packets" is only meaningful for non-snapshot modes
[lttng-docs.git] / 2.9 / lttng-docs-2.9.txt
diff --git a/2.9/lttng-docs-2.9.txt b/2.9/lttng-docs-2.9.txt
index d1cf92a2fb820a482b4143cf2ae6a2a12f1a034e..53d575f2d1edad7c5eedf1251defe4ac67b7a281 100644 (file)
--- a/2.9/lttng-docs-2.9.txt
+++ b/2.9/lttng-docs-2.9.txt
@@ -1,12 +1,15 @@
 The LTTng Documentation
 =======================
 Philippe Proulx <pproulx@efficios.com>
 The LTTng Documentation
 =======================
 Philippe Proulx <pproulx@efficios.com>
-v2.9, 2 December 2016
+v2.9, 25 February 2021
 
 
 include::../common/copyright.txt[]
 
 
 
 
 include::../common/copyright.txt[]
 
 
+include::../common/warning-not-maintained.txt[]
+
+
 include::../common/welcome.txt[]
 
 
 include::../common/welcome.txt[]
 
 
@@ -74,6 +77,15 @@ include::../common/acknowledgements.txt[]
 [[whats-new]]
 == What's new in LTTng {revision}?
 
 [[whats-new]]
 == What's new in LTTng {revision}?
 
+LTTng{nbsp}{revision} bears the name _Joannès_. A Berliner Weisse style
+beer from the http://letreflenoir.com/[Trèfle Noir] microbrewery in
+https://en.wikipedia.org/wiki/Rouyn-Noranda[Rouyn-Noranda], the
+https://www.beeradvocate.com/beer/profile/20537/238967/[_**Joannès**_]
+is a tangy beer with a distinct pink dress and intense fruit flavor,
+thanks to the presence of fresh blackcurrant grown in Témiscamingue.
+
+New features and changes in LTTng{nbsp}{revision}:
+
 * **Tracing control**:
 ** You can override the name or the URL of a tracing session
    configuration when you use man:lttng-load(1) thanks to the new
 * **Tracing control**:
 ** You can override the name or the URL of a tracing session
    configuration when you use man:lttng-load(1) thanks to the new
@@ -89,7 +101,7 @@ include::../common/acknowledgements.txt[]
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng add-context --kernel --type=perf:cpu:raw:r0013c:x86unhalted
+$ lttng add-context --kernel --type=perf:cpu:raw:r0013c:x86unhalted
 ----
 --
 +
 ----
 --
 +
@@ -307,6 +319,8 @@ becomes inactive or in real-time.
 [[installing-lttng]]
 == Installation
 
 [[installing-lttng]]
 == Installation
 
+include::../common/warning-no-installation.txt[]
+
 **LTTng** is a set of software <<plumbing,components>> which interact to
 <<instrumenting,instrument>> the Linux kernel and user applications, and
 to <<controlling-tracing,control tracing>> (start and stop
 **LTTng** is a set of software <<plumbing,components>> which interact to
 <<instrumenting,instrument>> the Linux kernel and user applications, and
 to <<controlling-tracing,control tracing>> (start and stop
@@ -321,174 +335,14 @@ components are bundled into the following packages:
   trace user applications.
 
 Most distributions mark the LTTng-modules and LTTng-UST packages as
   trace user applications.
 
 Most distributions mark the LTTng-modules and LTTng-UST packages as
-optional when installing LTTng-tools (which is always required). In the
-following sections, we always provide the steps to install all three,
-but note that:
+optional when installing LTTng-tools (which is always required). Note
+that:
 
 * You only need to install LTTng-modules if you intend to trace the
   Linux kernel.
 * You only need to install LTTng-UST if you intend to trace user
   applications.
 
 
 * You only need to install LTTng-modules if you intend to trace the
   Linux kernel.
 * You only need to install LTTng-UST if you intend to trace user
   applications.
 
-[role="growable"]
-.Availability of LTTng{nbsp}{revision} for major Linux distributions as of 2 December 2016.
-|====
-|Distribution |Available in releases |Alternatives
-
-|https://www.ubuntu.com/[Ubuntu]
-|Ubuntu{nbsp}14.04 _Trusty Tahr_ and Ubuntu{nbsp}16.04 _Xenial Xerus_:
-<<ubuntu-ppa,use the LTTng Stable{nbsp}{revision} PPA>>.
-|link:/docs/v2.8#doc-ubuntu[LTTng{nbsp}2.8 for Ubuntu{nbsp}16.10 _Yakkety Yak_].
-
-<<building-from-source,Build LTTng{nbsp}{revision} from source>> for
-other Ubuntu releases.
-
-|https://getfedora.org/[Fedora]
-|_Not available_
-|<<building-from-source,Build LTTng-modules{nbsp}{revision} from
-source>>.
-
-|https://www.debian.org/[Debian]
-|_Not available_
-|<<building-from-source,Build LTTng-modules{nbsp}{revision} from
-source>>.
-
-|https://www.opensuse.org/[openSUSE]
-|_Not available_
-|<<building-from-source,Build LTTng-modules{nbsp}{revision} from
-source>>.
-
-|https://www.archlinux.org/[Arch Linux]
-|<<arch-linux,Latest AUR packages>>.
-|
-
-|https://alpinelinux.org/[Alpine Linux]
-|_Not available_
-|link:/docs/v2.8#doc-alpine-linux[LTTng{nbsp}2.8 for Alpine Linux{nbsp}"edge"].
-
-LTTng{nbsp}2.8 for Alpine Linux{nbsp}3.5 (not released yet).
-
-<<building-from-source,Build LTTng{nbsp}{revision} from source>> for
-other Alpine Linux releases.
-
-|https://www.redhat.com/[RHEL] and https://www.suse.com/[SLES]
-|See http://packages.efficios.com/[EfficiOS Enterprise Packages].
-|
-
-|https://buildroot.org/[Buildroot]
-|_Not available_
-|link:/docs/v2.8#doc-buildroot[LTTng{nbsp}2.8 for Buildroot{nbsp}2016.11].
-
-<<building-from-source,Build LTTng{nbsp}{revision} from source>> for
-other Buildroot releases.
-
-|http://www.openembedded.org/wiki/Main_Page[OpenEmbedded] and
-https://www.yoctoproject.org/[Yocto]
-|_Not available_
-|link:/docs/v2.8#doc-oe-yocto[LTTng{nbsp}2.8 for Yocto Project{nbsp}2.2 _Morty_]
-(`openembedded-core` layer).
-
-<<building-from-source,Build LTTng{nbsp}{revision} from source>> for
-other OpenEmbedded releases.
-|====
-
-
-[[ubuntu]]
-=== [[ubuntu-official-repositories]]Ubuntu
-
-[[ubuntu-ppa]]
-==== noch:{LTTng} Stable {revision} PPA
-
-The https://launchpad.net/~lttng/+archive/ubuntu/stable-{revision}[LTTng
-Stable{nbsp}{revision} PPA] offers the latest stable
-LTTng{nbsp}{revision} packages for:
-
-* Ubuntu{nbsp}14.04 _Trusty Tahr_
-* Ubuntu{nbsp}16.04 _Xenial Xerus_
-
-To install LTTng{nbsp}{revision} from the LTTng Stable{nbsp}{revision} PPA:
-
-. Add the LTTng Stable{nbsp}{revision} PPA repository and update the
-  list of packages:
-+
---
-[role="term"]
-----
-sudo apt-add-repository ppa:lttng/stable-2.9
-sudo apt-get update
-----
---
-
-. Install the main LTTng{nbsp}{revision} packages:
-+
---
-[role="term"]
-----
-sudo apt-get install lttng-tools
-sudo apt-get install lttng-modules-dkms
-sudo apt-get install liblttng-ust-dev
-----
---
-
-. **If you need to instrument and trace
-  <<java-application,Java applications>>**, install the LTTng-UST
-  Java agent:
-+
---
-[role="term"]
-----
-sudo apt-get install liblttng-ust-agent-java
-----
---
-
-. **If you need to instrument and trace
-  <<python-application,Python{nbsp}3 applications>>**, install the
-  LTTng-UST Python agent:
-+
---
-[role="term"]
-----
-sudo apt-get install python3-lttngust
-----
---
-
-
-[[arch-linux]]
-=== Arch Linux
-
-To install LTTng{nbsp}{revision} on Arch Linux using
-https://archlinux.fr/yaourt-en[Yaourt]:
-
-. Install the main LTTng{nbsp}{revision} packages:
-+
---
-[role="term"]
-----
-yaourt -S lttng-tools
-yaourt -S lttng-ust
-yaourt -S lttng-modules
-----
---
-
-. **If you need to instrument and trace <<python-application,Python
-  applications>>**, install the LTTng-UST Python agent:
-+
---
-[role="term"]
-----
-yaourt -S python-lttngust
-yaourt -S python2-lttngust
-----
---
-
-
-[[enterprise-distributions]]
-=== RHEL, SUSE, and other enterprise distributions
-
-To install LTTng on enterprise Linux distributions, such as Red Hat
-Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SUSE), please
-see http://packages.efficios.com/[EfficiOS Enterprise Packages].
-
 
 [[building-from-source]]
 === Build from source
 
 [[building-from-source]]
 === Build from source
@@ -510,7 +364,7 @@ To build and install LTTng{nbsp}{revision} from source:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.9.tar.bz2 &&
 tar -xf lttng-modules-latest-2.9.tar.bz2 &&
 cd lttng-modules-2.9.* &&
 wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.9.tar.bz2 &&
 tar -xf lttng-modules-latest-2.9.tar.bz2 &&
 cd lttng-modules-2.9.* &&
@@ -525,7 +379,7 @@ sudo depmod -a
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-ust/lttng-ust-latest-2.9.tar.bz2 &&
 tar -xf lttng-ust-latest-2.9.tar.bz2 &&
 cd lttng-ust-2.9.* &&
 wget http://lttng.org/files/lttng-ust/lttng-ust-latest-2.9.tar.bz2 &&
 tar -xf lttng-ust-latest-2.9.tar.bz2 &&
 cd lttng-ust-2.9.* &&
@@ -575,7 +429,7 @@ instrumented user application with `liblttng-ust`>>:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
@@ -613,16 +467,18 @@ This tutorial walks you through the steps to:
 [[tracing-the-linux-kernel]]
 === Trace the Linux kernel
 
 [[tracing-the-linux-kernel]]
 === Trace the Linux kernel
 
-The following command lines start with cmd:sudo because you need root
-privileges to trace the Linux kernel. You can avoid using cmd:sudo if
-your Unix user is a member of the <<lttng-sessiond,tracing group>>.
+The following command lines start with the `#` prompt because you need
+root privileges to trace the Linux kernel. You can also trace the kernel
+as a regular user if your Unix user is a member of the
+<<tracing-group,tracing group>>.
 
 
-. Create a <<tracing-session,tracing session>>:
+. Create a <<tracing-session,tracing session>> which writes its traces
+  to dir:{/tmp/my-kernel-trace}:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-sudo lttng create my-kernel-session
+# lttng create my-kernel-session --output=/tmp/my-kernel-trace
 ----
 --
 
 ----
 --
 
@@ -631,58 +487,67 @@ sudo lttng create my-kernel-session
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng list --kernel
+# lttng list --kernel
+# lttng list --kernel --syscall
 ----
 --
 
 ----
 --
 
-. Create an <<event,event rule>> which matches the desired event names,
-  for example `sched_switch` and `sched_process_fork`:
+. Create <<event,event rules>> which match the desired instrumentation
+  point names, for example the `sched_switch` and `sched_process_fork`
+  tracepoints, and the man:open(2) and man:close(2) system calls:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-sudo lttng enable-event --kernel sched_switch,sched_process_fork
+# lttng enable-event --kernel sched_switch,sched_process_fork
+# lttng enable-event --kernel --syscall open,close
 ----
 --
 +
 ----
 --
 +
-You can also create an event rule which _matches_ all the Linux kernel
+You can also create an event rule which matches _all_ the Linux kernel
 tracepoints (this will generate a lot of data when tracing):
 +
 --
 [role="term"]
 ----
 tracepoints (this will generate a lot of data when tracing):
 +
 --
 [role="term"]
 ----
-sudo lttng enable-event --kernel --all
+# lttng enable-event --kernel --all
 ----
 --
 
 ----
 --
 
-. Start tracing:
+. <<basic-tracing-session-control,Start tracing>>:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-sudo lttng start
+# lttng start
 ----
 --
 
 . Do some operation on your system for a few seconds. For example,
   load a website, or list the files of a directory.
 ----
 --
 
 . Do some operation on your system for a few seconds. For example,
   load a website, or list the files of a directory.
-. Stop tracing and destroy the tracing session:
+. <<basic-tracing-session-control,Stop tracing>> and destroy the
+  tracing session:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-sudo lttng stop
-sudo lttng destroy
+# lttng stop
+# lttng destroy
 ----
 --
 +
 The man:lttng-destroy(1) command does not destroy the trace data; it
 only destroys the state of the tracing session.
 
 ----
 --
 +
 The man:lttng-destroy(1) command does not destroy the trace data; it
 only destroys the state of the tracing session.
 
-By default, LTTng saves the traces in
-+$LTTNG_HOME/lttng-traces/__name__-__date__-__time__+,
-where +__name__+ is the tracing session name. Note that the
-env:LTTNG_HOME environment variable defaults to `$HOME` if not set.
+. For the sake of this example, make the recorded trace accessible to
+  the non-root users:
++
+--
+[role="term"]
+----
+# chown -R $(whoami) /tmp/my-kernel-trace
+----
+--
 
 See <<viewing-and-analyzing-your-traces,View and analyze the
 recorded events>> to view the recorded events.
 
 See <<viewing-and-analyzing-your-traces,View and analyze the
 recorded events>> to view the recorded events.
@@ -751,7 +616,7 @@ TRACEPOINT_EVENT(
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c -I. hello-tp.c
+$ gcc -c -I. hello-tp.c
 ----
 --
 
 ----
 --
 
@@ -811,7 +676,7 @@ int main(int argc, char *argv[])
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c hello.c
+$ gcc -c hello.c
 ----
 --
 
 ----
 --
 
@@ -821,7 +686,7 @@ gcc -c hello.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o hello hello.o hello-tp.o -llttng-ust -ldl
+$ gcc -o hello hello.o hello-tp.o -llttng-ust -ldl
 ----
 --
 
 ----
 --
 
@@ -838,7 +703,7 @@ To trace the user application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./hello world and beyond
+$ ./hello world and beyond
 ----
 --
 +
 ----
 --
 +
@@ -856,7 +721,7 @@ Press Enter to continue...
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng-sessiond --daemonize
+$ lttng-sessiond --daemonize
 ----
 --
 +
 ----
 --
 +
@@ -868,7 +733,7 @@ a service that the distribution's service manager started.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng list --userspace
+$ lttng list --userspace
 ----
 --
 +
 ----
 --
 +
@@ -880,7 +745,7 @@ under the `./hello` process.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create my-user-space-session
+$ lttng create my-user-space-session
 ----
 --
 
 ----
 --
 
@@ -890,28 +755,29 @@ lttng create my-user-space-session
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng enable-event --userspace hello_world:my_first_tracepoint
+$ lttng enable-event --userspace hello_world:my_first_tracepoint
 ----
 --
 
 ----
 --
 
-. Start tracing:
+. <<basic-tracing-session-control,Start tracing>>:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-lttng start
+$ lttng start
 ----
 --
 
 . Go back to the running `hello` application and press Enter. The
   program executes all `tracepoint()` instrumentation points and exits.
 ----
 --
 
 . Go back to the running `hello` application and press Enter. The
   program executes all `tracepoint()` instrumentation points and exits.
-. Stop tracing and destroy the tracing session:
+. <<basic-tracing-session-control,Stop tracing>> and destroy the
+  tracing session:
 +
 --
 [role="term"]
 ----
 +
 --
 [role="term"]
 ----
-sudo lttng stop
-sudo lttng destroy
+$ lttng stop
+$ lttng destroy
 ----
 --
 +
 ----
 --
 +
@@ -920,7 +786,7 @@ only destroys the state of the tracing session.
 
 By default, LTTng saves the traces in
 +$LTTNG_HOME/lttng-traces/__name__-__date__-__time__+,
 
 By default, LTTng saves the traces in
 +$LTTNG_HOME/lttng-traces/__name__-__date__-__time__+,
-where +__name__+ is the tracing session name. Note that the
+where +__name__+ is the tracing session name. The
 env:LTTNG_HOME environment variable defaults to `$HOME` if not set.
 
 See <<viewing-and-analyzing-your-traces,View and analyze the
 env:LTTNG_HOME environment variable defaults to `$HOME` if not set.
 
 See <<viewing-and-analyzing-your-traces,View and analyze the
@@ -954,7 +820,7 @@ Many tools are available to read LTTng traces:
 
 NOTE: This section assumes that the traces recorded during the previous
 tutorials were saved to their default location, in the
 
 NOTE: This section assumes that the traces recorded during the previous
 tutorials were saved to their default location, in the
-dir:{$LTTNG_HOME/lttng-traces} directory. Note that the env:LTTNG_HOME
+dir:{$LTTNG_HOME/lttng-traces} directory. The env:LTTNG_HOME
 environment variable defaults to `$HOME` if not set.
 
 
 environment variable defaults to `$HOME` if not set.
 
 
@@ -966,7 +832,7 @@ its path to cmd:babeltrace with no options:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-babeltrace ~/lttng-traces/my-user-space-session*
+$ babeltrace ~/lttng-traces/my-user-space-session*
 ----
 
 cmd:babeltrace finds all traces recursively within the given path and
 ----
 
 cmd:babeltrace finds all traces recursively within the given path and
@@ -977,7 +843,7 @@ further filtering:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-babeltrace ~/lttng-traces/my-kernel-session* | grep sys_
+$ babeltrace /tmp/my-kernel-trace | grep _switch
 ----
 
 You can pipe the output of cmd:babeltrace into a tool like man:wc(1) to
 ----
 
 You can pipe the output of cmd:babeltrace into a tool like man:wc(1) to
@@ -985,7 +851,7 @@ count the recorded events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-babeltrace ~/lttng-traces/my-kernel-session* | grep sys_read | wc --lines
+$ babeltrace /tmp/my-kernel-trace | grep _open | wc --lines
 ----
 
 
 ----
 
 
@@ -1087,7 +953,7 @@ Run this script:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-python3 top5proc.py ~/lttng-traces/my-kernel-session*/kernel
+$ python3 top5proc.py /tmp/my-kernel-trace/kernel
 ----
 
 Output example:
 ----
 
 Output example:
@@ -1167,11 +1033,11 @@ LTTng can send the generated trace data to different locations. The
 _tracing session mode_ dictates where to send it. The following modes
 are available in LTTng{nbsp}{revision}:
 
 _tracing session mode_ dictates where to send it. The following modes
 are available in LTTng{nbsp}{revision}:
 
-Local mode::
+[[local-mode]]Local mode::
   LTTng writes the traces to the file system of the machine being traced
   (target system).
 
   LTTng writes the traces to the file system of the machine being traced
   (target system).
 
-Network streaming mode::
+[[net-streaming-mode]]Network streaming mode::
   LTTng sends the traces over the network to a
   <<lttng-relayd,relay daemon>> running on a remote system.
 
   LTTng sends the traces over the network to a
   <<lttng-relayd,relay daemon>> running on a remote system.
 
@@ -1182,7 +1048,7 @@ Snapshot mode::
   or to send it over the network to a <<lttng-relayd,relay daemon>>
   running on a remote system.
 
   or to send it over the network to a <<lttng-relayd,relay daemon>>
   running on a remote system.
 
-Live mode::
+[[live-mode]]Live mode::
   This mode is similar to the network streaming mode, but a live
   trace viewer can connect to the distant relay daemon to
   <<lttng-live,view event records as LTTng generates them>> by
   This mode is similar to the network streaming mode, but a live
   trace viewer can connect to the distant relay daemon to
   <<lttng-live,view event records as LTTng generates them>> by
@@ -1337,10 +1203,19 @@ as soon as a there's no space left for a new event record, whereas in
 discard mode, the tracer only discards the event record that doesn't
 fit.
 
 discard mode, the tracer only discards the event record that doesn't
 fit.
 
-In discard mode, LTTng increments a count of lost event records when
-an event record is lost and saves this count to the trace. In
-overwrite mode, LTTng keeps no information when it overwrites a
-sub-buffer before consuming it.
+In discard mode, LTTng increments a count of lost event records when an
+event record is lost and saves this count to the trace. Since
+LTTng{nbsp}2.8, in overwrite mode, LTTng writes to a given sub-buffer
+its sequence number within its data stream. With a <<local-mode,local>>,
+<<net-streaming-mode,network streaming>>, or <<live-mode,live>>
+<<tracing-session,tracing session>>, a trace reader can use such
+sequence numbers to report lost packets. In overwrite mode, LTTng
+doesn't write to the trace the exact number of lost event records in
+those lost sub-buffers.
+
+Trace analyses can use saved discarded event record and sub-buffer
+(packet) counts of the trace to decide whether or not to perform the
+analyses even if trace data is known to be missing.
 
 There are a few ways to decrease your probability of losing event
 records.
 
 There are a few ways to decrease your probability of losing event
 records.
@@ -1365,8 +1240,8 @@ to configure the sub-buffer count and size for them:
 * **High event throughput**: In general, prefer bigger sub-buffers to
   lower the risk of losing event records.
 +
 * **High event throughput**: In general, prefer bigger sub-buffers to
   lower the risk of losing event records.
 +
-Having bigger sub-buffers also ensures a lower sub-buffer switching
-frequency.
+Having bigger sub-buffers also ensures a lower
+<<channel-switch-timer,sub-buffer switching frequency>>.
 +
 The number of sub-buffers is only meaningful if you create the channel
 in overwrite mode: in this case, if a sub-buffer overwrite happens, the
 +
 The number of sub-buffers is only meaningful if you create the channel
 in overwrite mode: in this case, if a sub-buffer overwrite happens, the
@@ -1520,7 +1395,7 @@ With so many similar terms, it's easy to get confused.
 An **event** is the consequence of the execution of an _instrumentation
 point_, like a tracepoint that you manually place in some source code,
 or a Linux kernel KProbe. An event is said to _occur_ at a specific
 An **event** is the consequence of the execution of an _instrumentation
 point_, like a tracepoint that you manually place in some source code,
 or a Linux kernel KProbe. An event is said to _occur_ at a specific
-time. Different actions can be taken upon the occurance of an event,
+time. Different actions can be taken upon the occurrence of an event,
 like record the event's payload to a buffer.
 
 An **event record** is the representation of an event in a sub-buffer. A
 like record the event's payload to a buffer.
 
 An **event record** is the representation of an event in a sub-buffer. A
@@ -1555,7 +1430,7 @@ The LTTng project incorporates:
 * **LTTng-tools**: Libraries and command-line interface to
   control tracing sessions.
 ** <<lttng-sessiond,Session daemon>> (man:lttng-sessiond(8)).
 * **LTTng-tools**: Libraries and command-line interface to
   control tracing sessions.
 ** <<lttng-sessiond,Session daemon>> (man:lttng-sessiond(8)).
-** <<lttng-consumerd,Consumer daemon>> (man:lttng-consumerd(8)).
+** <<lttng-consumerd,Consumer daemon>> (cmd:lttng-consumerd).
 ** <<lttng-relayd,Relay daemon>> (man:lttng-relayd(8)).
 ** <<liblttng-ctl-lttng,Tracing control library>> (`liblttng-ctl`).
 ** <<lttng-cli,Tracing control command-line tool>> (man:lttng(1)).
 ** <<lttng-relayd,Relay daemon>> (man:lttng-relayd(8)).
 ** <<liblttng-ctl-lttng,Tracing control library>> (`liblttng-ctl`).
 ** <<lttng-cli,Tracing control command-line tool>> (man:lttng(1)).
@@ -1603,7 +1478,7 @@ The cmd:lttng tool has a Git-like interface:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng <general options> <command> <command options>
+$ lttng <GENERAL OPTIONS> <COMMAND> <COMMAND OPTIONS>
 ----
 
 The <<controlling-tracing,Tracing control>> section explores the
 ----
 
 The <<controlling-tracing,Tracing control>> section explores the
@@ -1851,7 +1726,7 @@ running. You can also start the session daemon manually.
 .The consumer daemon.
 image::plumbing-consumerd.png[]
 
 .The consumer daemon.
 image::plumbing-consumerd.png[]
 
-The _consumer daemon_, man:lttng-consumerd(8), is a daemon which shares
+The _consumer daemon_, cmd:lttng-consumerd, is a daemon which shares
 ring buffers with user applications or with the LTTng kernel modules to
 collect trace data and send it to some location (on disk or to a
 <<lttng-relayd,relay daemon>> over the network). The consumer daemon
 ring buffers with user applications or with the LTTng kernel modules to
 collect trace data and send it to some location (on disk or to a
 <<lttng-relayd,relay daemon>> over the network). The consumer daemon
@@ -2692,7 +2567,7 @@ To build the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -2701,7 +2576,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o tpp.o -llttng-ust -ldl
+$ gcc -o app app.o tpp.o -llttng-ust -ldl
 ----
 --
 
 ----
 --
 
@@ -2712,7 +2587,7 @@ To run the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -2730,7 +2605,7 @@ To create the tracepoint provider package archive file:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -c tpp.c
+$ gcc -I. -c tpp.c
 ----
 --
 
 ----
 --
 
@@ -2739,7 +2614,7 @@ gcc -I. -c tpp.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-ar rcs tpp.a tpp.o
+$ ar rcs tpp.a tpp.o
 ----
 --
 
 ----
 --
 
@@ -2759,7 +2634,7 @@ To build the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -2768,7 +2643,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o tpp.a -llttng-ust -ldl
+$ gcc -o app app.o tpp.a -llttng-ust -ldl
 ----
 --
 
 ----
 --
 
@@ -2779,7 +2654,7 @@ To run the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -2808,7 +2683,7 @@ To build the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -2817,7 +2692,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -ldl -L. -ltpp
+$ gcc -o app app.o -ldl -L. -ltpp
 ----
 --
 
 ----
 --
 
@@ -2828,7 +2703,7 @@ To run the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -2859,7 +2734,7 @@ To build the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -2868,7 +2743,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -ldl
+$ gcc -o app app.o -ldl
 ----
 --
 
 ----
 --
 
@@ -2880,7 +2755,7 @@ To run the instrumented application with tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-LD_PRELOAD=./libtpp.so ./app
+$ LD_PRELOAD=./libtpp.so ./app
 ----
 --
 
 ----
 --
 
@@ -2891,7 +2766,7 @@ To run the instrumented application without tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -2924,7 +2799,7 @@ To build the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -2933,7 +2808,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -ldl
+$ gcc -o app app.o -ldl
 ----
 --
 
 ----
 --
 
@@ -2944,7 +2819,7 @@ To run the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -2976,7 +2851,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -2985,7 +2860,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o tpp.o -llttng-ust -ldl
+$ gcc -shared -o libemon.so emon.o tpp.o -llttng-ust -ldl
 ----
 --
 
 ----
 --
 
@@ -2996,7 +2871,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3005,7 +2880,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -L. -lemon
+$ gcc -o app app.o -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3016,7 +2891,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3048,7 +2923,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3057,7 +2932,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl -L. -ltpp
+$ gcc -shared -o libemon.so emon.o -ldl -L. -ltpp
 ----
 --
 
 ----
 --
 
@@ -3068,7 +2943,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3077,7 +2952,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -L. -lemon
+$ gcc -o app app.o -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3088,7 +2963,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3121,7 +2996,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3130,7 +3005,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl
+$ gcc -shared -o libemon.so emon.o -ldl
 ----
 --
 
 ----
 --
 
@@ -3141,7 +3016,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3150,7 +3025,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -L. -lemon
+$ gcc -o app app.o -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3162,7 +3037,7 @@ To run the application with tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-LD_PRELOAD=./libtpp.so ./app
+$ LD_PRELOAD=./libtpp.so ./app
 ----
 --
 
 ----
 --
 
@@ -3173,7 +3048,7 @@ To run the application without tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3208,7 +3083,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3217,7 +3092,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl
+$ gcc -shared -o libemon.so emon.o -ldl
 ----
 --
 
 ----
 --
 
@@ -3228,7 +3103,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3237,7 +3112,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -L. -lemon
+$ gcc -o app app.o -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3248,7 +3123,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3282,7 +3157,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3291,7 +3166,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl -L. -ltpp
+$ gcc -shared -o libemon.so emon.o -ldl -L. -ltpp
 ----
 --
 
 ----
 --
 
@@ -3302,7 +3177,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3311,7 +3186,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -ldl -L. -lemon
+$ gcc -o app app.o -ldl -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3322,7 +3197,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3357,7 +3232,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3366,7 +3241,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl
+$ gcc -shared -o libemon.so emon.o -ldl
 ----
 --
 
 ----
 --
 
@@ -3377,7 +3252,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3386,7 +3261,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -ldl -L. -lemon
+$ gcc -o app app.o -ldl -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3397,7 +3272,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3430,7 +3305,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3439,7 +3314,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o -ldl
+$ gcc -shared -o libemon.so emon.o -ldl
 ----
 --
 
 ----
 --
 
@@ -3450,7 +3325,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3459,7 +3334,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o -L. -lemon
+$ gcc -o app app.o -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3471,7 +3346,7 @@ To run the application with tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-LD_PRELOAD=./libtpp.so ./app
+$ LD_PRELOAD=./libtpp.so ./app
 ----
 --
 
 ----
 --
 
@@ -3482,7 +3357,7 @@ To run the application without tracing support:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3514,7 +3389,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3523,7 +3398,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o
+$ gcc -shared -o libemon.so emon.o
 ----
 --
 
 ----
 --
 
@@ -3534,7 +3409,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3543,7 +3418,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.o tpp.o -llttng-ust -ldl -L. -lemon
+$ gcc -o app app.o tpp.o -llttng-ust -ldl -L. -lemon
 ----
 --
 
 ----
 --
 
@@ -3554,7 +3429,7 @@ To run the instrumented application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 
 ----
 --
 
@@ -3585,7 +3460,7 @@ To build the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -c app.c
+$ gcc -c app.c
 ----
 --
 
 ----
 --
 
@@ -3594,7 +3469,7 @@ gcc -c app.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -Wl,--export-dynamic -o app app.o tpp.o \
+$ gcc -Wl,--export-dynamic -o app app.o tpp.o \
     -llttng-ust -ldl
 ----
 --
     -llttng-ust -ldl
 ----
 --
@@ -3610,7 +3485,7 @@ To build the instrumented user library:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -I. -fpic -c emon.c
+$ gcc -I. -fpic -c emon.c
 ----
 --
 
 ----
 --
 
@@ -3619,7 +3494,7 @@ gcc -I. -fpic -c emon.c
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -shared -o libemon.so emon.o
+$ gcc -shared -o libemon.so emon.o
 ----
 --
 
 ----
 --
 
@@ -3630,7 +3505,7 @@ To run the application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-./app
+$ ./app
 ----
 --
 |====
 ----
 --
 |====
@@ -3669,7 +3544,7 @@ object when you start the application.
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-LD_PRELOAD=liblttng-ust-fork.so ./my-app
+$ LD_PRELOAD=liblttng-ust-fork.so ./my-app
 ----
 
 If your tracepoint provider package is
 ----
 
 If your tracepoint provider package is
@@ -3678,7 +3553,7 @@ shared objects in env:LD_PRELOAD:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-LD_PRELOAD=liblttng-ust-fork.so:/path/to/tp.so ./my-app
+$ LD_PRELOAD=liblttng-ust-fork.so:/path/to/tp.so ./my-app
 ----
 
 
 ----
 
 
@@ -3692,7 +3567,7 @@ path:{liblttng-ust-fd.so} shared object when you start the application:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-LD_PRELOAD=liblttng-ust-fd.so ./my-app
+$ LD_PRELOAD=liblttng-ust-fd.so ./my-app
 ----
 
 Typical use cases include closing all the file descriptors after
 ----
 
 Typical use cases include closing all the file descriptors after
@@ -3710,7 +3585,7 @@ build an application on the command line:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-gcc -o my-app my-app.o tp.o $(pkg-config --cflags --libs lttng-ust)
+$ gcc -o my-app my-app.o tp.o $(pkg-config --cflags --libs lttng-ust)
 ----
 
 
 ----
 
 
@@ -3735,7 +3610,7 @@ or LTTng packages:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/urcu/userspace-rcu-latest-0.9.tar.bz2 &&
 tar -xf userspace-rcu-latest-0.9.tar.bz2 &&
 cd userspace-rcu-0.9.* &&
 wget http://lttng.org/files/urcu/userspace-rcu-latest-0.9.tar.bz2 &&
 tar -xf userspace-rcu-latest-0.9.tar.bz2 &&
 cd userspace-rcu-0.9.* &&
@@ -3762,7 +3637,7 @@ sudo ldconfig
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-ust/lttng-ust-latest-2.9.tar.bz2 &&
 tar -xf lttng-ust-latest-2.9.tar.bz2 &&
 cd lttng-ust-2.9.* &&
 wget http://lttng.org/files/lttng-ust/lttng-ust-latest-2.9.tar.bz2 &&
 tar -xf lttng-ust-latest-2.9.tar.bz2 &&
 cd lttng-ust-2.9.* &&
@@ -3787,7 +3662,7 @@ relevant 32-bit library paths, for example:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-LDFLAGS='-L/usr/lib/i386-linux-gnu -L/usr/lib32'
+$ LDFLAGS='-L/usr/lib/i386-linux-gnu -L/usr/lib32'
 ----
 ====
 
 ----
 ====
 
@@ -3797,12 +3672,14 @@ LDFLAGS='-L/usr/lib/i386-linux-gnu -L/usr/lib32'
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
 ./configure --libdir=/usr/local/lib32 CFLAGS=-m32 CXXFLAGS=-m32 \
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
 ./configure --libdir=/usr/local/lib32 CFLAGS=-m32 CXXFLAGS=-m32 \
-            LDFLAGS='-L/usr/local/lib32 -L/usr/lib32' &&
+            LDFLAGS='-L/usr/local/lib32 -L/usr/lib32' \
+            --disable-bin-lttng --disable-bin-lttng-crash \
+            --disable-bin-lttng-relayd --disable-bin-lttng-sessiond &&
 make &&
 cd src/bin/lttng-consumerd &&
 sudo make install &&
 make &&
 cd src/bin/lttng-consumerd &&
 sudo make install &&
@@ -3819,7 +3696,7 @@ sudo ldconfig
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
 wget http://lttng.org/files/lttng-tools/lttng-tools-latest-2.9.tar.bz2 &&
 tar -xf lttng-tools-latest-2.9.tar.bz2 &&
 cd lttng-tools-2.9.* &&
@@ -3846,9 +3723,9 @@ instrumented 32-bit application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -m32 -c -I. hello-tp.c
-gcc -m32 -c hello.c
-gcc -m32 -o hello hello.o hello-tp.o \
+$ gcc -m32 -c -I. hello-tp.c
+$ gcc -m32 -c hello.c
+$ gcc -m32 -o hello hello.o hello-tp.o \
     -L/usr/lib32 -L/usr/local/lib32 \
     -Wl,-rpath,/usr/lib32,-rpath,/usr/local/lib32 \
     -llttng-ust -ldl
     -L/usr/lib32 -L/usr/local/lib32 \
     -Wl,-rpath,/usr/lib32,-rpath,/usr/local/lib32 \
     -llttng-ust -ldl
@@ -3900,7 +3777,7 @@ To use `tracef()` in your application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.c -llttng-ust
+$ gcc -o app app.c -llttng-ust
 ----
 --
 
 ----
 --
 
@@ -3912,7 +3789,7 @@ To trace the events that `tracef()` calls emit:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng enable-event --userspace 'lttng_ust_tracef:*'
+$ lttng enable-event --userspace 'lttng_ust_tracef:*'
 ----
 --
 
 ----
 --
 
@@ -3987,7 +3864,7 @@ See man:lttng-ust(3) for a list of available log level names.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-gcc -o app app.c -llttng-ust
+$ gcc -o app app.c -llttng-ust
 ----
 --
 
 ----
 --
 
@@ -4001,7 +3878,7 @@ _as severe as_ a specific log level:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng enable-event --userspace 'lttng_ust_tracelog:*'
+$ lttng enable-event --userspace 'lttng_ust_tracelog:*'
                    --loglevel=TRACE_WARNING
 ----
 --
                    --loglevel=TRACE_WARNING
 ----
 --
@@ -4015,7 +3892,7 @@ _specific log level_:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng enable-event --userspace 'lttng_ust_tracelog:*'
+$ lttng enable-event --userspace 'lttng_ust_tracelog:*'
                    --loglevel-only=TRACE_INFO
 ----
 --
                    --loglevel-only=TRACE_INFO
 ----
 --
@@ -4024,7 +3901,7 @@ lttng enable-event --userspace 'lttng_ust_tracelog:*'
 [[prebuilt-ust-helpers]]
 === Prebuilt user space tracing helpers
 
 [[prebuilt-ust-helpers]]
 === Prebuilt user space tracing helpers
 
-The LTTng-UST package provides a few helpers in the form or preloadable
+The LTTng-UST package provides a few helpers in the form of preloadable
 shared objects which automatically instrument system functions and
 calls.
 
 shared objects which automatically instrument system functions and
 calls.
 
@@ -4054,7 +3931,7 @@ To use a user space tracing helper with any user application:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-LD_PRELOAD=liblttng-ust-libc-wrapper.so my-app
+$ LD_PRELOAD=liblttng-ust-libc-wrapper.so my-app
 ----
 --
 +
 ----
 --
 +
@@ -4063,7 +3940,7 @@ You can preload more than one helper:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-LD_PRELOAD=liblttng-ust-libc-wrapper.so:liblttng-ust-dl.so my-app
+$ LD_PRELOAD=liblttng-ust-libc-wrapper.so:liblttng-ust-dl.so my-app
 ----
 --
 
 ----
 --
 
@@ -4113,7 +3990,7 @@ The path:{liblttng-ust-cyg-profile*.so} helpers can add instrumentation
 to the entry and exit points of functions.
 
 man:gcc(1) and man:clang(1) have an option named
 to the entry and exit points of functions.
 
 man:gcc(1) and man:clang(1) have an option named
-https://gcc.gnu.org/onlinedocs/gcc/Code-Gen-Options.html[`-finstrument-functions`]
+https://gcc.gnu.org/onlinedocs/gcc/Instrumentation-Options.html[`-finstrument-functions`]
 which generates instrumentation calls for entry and exit to functions.
 The LTTng-UST function tracing helpers,
 path:{liblttng-ust-cyg-profile.so} and
 which generates instrumentation calls for entry and exit to functions.
 The LTTng-UST function tracing helpers,
 path:{liblttng-ust-cyg-profile.so} and
@@ -4186,7 +4063,7 @@ logging frameworks:
 .LTTng-UST Java agent imported by a Java application.
 image::java-app.png[]
 
 .LTTng-UST Java agent imported by a Java application.
 image::java-app.png[]
 
-Note that the methods described below are new in LTTng{nbsp}{revision}.
+Note that the methods described below are new in LTTng{nbsp}2.8.
 Previous LTTng versions use another technique.
 
 NOTE: We use http://openjdk.java.net/[OpenJDK]{nbsp}8 for development
 Previous LTTng versions use another technique.
 
 NOTE: We use http://openjdk.java.net/[OpenJDK]{nbsp}8 for development
@@ -4306,7 +4183,7 @@ Build this example:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar Test.java
+$ javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar Test.java
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>,
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>,
@@ -4315,16 +4192,16 @@ javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jar
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng create
-lttng enable-event --jul jello
-lttng start
+$ lttng create
+$ lttng enable-event --jul jello
+$ lttng start
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
-java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar:. Test
+$ java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar:. Test
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
@@ -4332,11 +4209,36 @@ recorded events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng stop
-lttng view
+$ lttng stop
+$ lttng view
 ----
 ====
 
 ----
 ====
 
+In the resulting trace, an <<event,event record>> generated by a Java
+application using `java.util.logging` is named `lttng_jul:event` and
+has the following fields:
+
+`msg`::
+  Log record's message.
+
+`logger_name`::
+  Logger name.
+
+`class_name`::
+  Name of the class in which the log statement was executed.
+
+`method_name`::
+  Name of the method in which the log statement was executed.
+
+`long_millis`::
+  Logging time (timestamp in milliseconds).
+
+`int_loglevel`::
+  Log level integer value.
+
+`int_threadid`::
+  ID of the thread in which the log statement was executed.
+
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of JUL log levels
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of JUL log levels
@@ -4454,7 +4356,7 @@ file):
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-log4j.jar:$LOG4JPATH Test.java
+$ javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-log4j.jar:$LOG4JPATH Test.java
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>,
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>,
@@ -4463,16 +4365,16 @@ javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jar
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng create
-lttng enable-event --log4j jello
-lttng start
+$ lttng create
+$ lttng enable-event --log4j jello
+$ lttng start
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
-java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-log4j.jar:$LOG4JPATH:. Test
+$ java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-log4j.jar:$LOG4JPATH:. Test
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
@@ -4480,11 +4382,42 @@ recorded events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng stop
-lttng view
+$ lttng stop
+$ lttng view
 ----
 ====
 
 ----
 ====
 
+In the resulting trace, an <<event,event record>> generated by a Java
+application using log4j is named `lttng_log4j:event` and
+has the following fields:
+
+`msg`::
+  Log record's message.
+
+`logger_name`::
+  Logger name.
+
+`class_name`::
+  Name of the class in which the log statement was executed.
+
+`method_name`::
+  Name of the method in which the log statement was executed.
+
+`filename`::
+  Name of the file in which the executed log statement is located.
+
+`line_number`::
+  Line number at which the log statement was executed.
+
+`timestamp`::
+  Logging timestamp.
+
+`int_loglevel`::
+  Log level integer value.
+
+`thread_name`::
+  Name of the Java thread in which the log statement was executed.
+
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of Apache log4j log levels
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of Apache log4j log levels
@@ -4654,7 +4587,7 @@ Build this example:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar Test.java
+$ javac -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar Test.java
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>
 ----
 
 <<creating-destroying-tracing-sessions,Create a tracing session>>
@@ -4663,8 +4596,8 @@ and <<enabling-disabling-events,create an event rule>> matching the
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng create
-lttng enable-event --jul jello
+$ lttng create
+$ lttng enable-event --jul jello
 ----
 
 <<adding-context,Add the application-specific context fields>> to the
 ----
 
 <<adding-context,Add the application-specific context fields>> to the
@@ -4672,22 +4605,22 @@ JUL channel:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng add-context --jul --type='$app.myRetriever:intCtx'
-lttng add-context --jul --type='$app.myRetriever:strContext'
+$ lttng add-context --jul --type='$app.myRetriever:intCtx'
+$ lttng add-context --jul --type='$app.myRetriever:strContext'
 ----
 
 <<basic-tracing-session-control,Start tracing>>:
 
 [role="term"]
 ----
 ----
 
 <<basic-tracing-session-control,Start tracing>>:
 
 [role="term"]
 ----
-lttng start
+$ lttng start
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
 ----
 
 Run the compiled class:
 
 [role="term"]
 ----
-java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar:. Test
+$ java -cp /usr/share/java/jarpath/lttng-ust-agent-common.jar:/usr/share/java/jarpath/lttng-ust-agent-jul.jar:. Test
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the
@@ -4695,8 +4628,8 @@ recorded events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng stop
-lttng view
+$ lttng stop
+$ lttng view
 ----
 ====
 
 ----
 ====
 
@@ -4782,16 +4715,16 @@ tracing>>:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng create
-lttng enable-event --python my-logger
-lttng start
+$ lttng create
+$ lttng enable-event --python my-logger
+$ lttng start
 ----
 
 Run the Python script:
 
 [role="term"]
 ----
 ----
 
 Run the Python script:
 
 [role="term"]
 ----
-python test.py
+$ python test.py
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the recorded
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the recorded
@@ -4799,11 +4732,38 @@ events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng stop
-lttng view
+$ lttng stop
+$ lttng view
 ----
 ====
 
 ----
 ====
 
+In the resulting trace, an <<event,event record>> generated by a Python
+application is named `lttng_python:event` and has the following fields:
+
+`asctime`::
+  Logging time (string).
+
+`msg`::
+  Log record's message.
+
+`logger_name`::
+  Logger name.
+
+`funcName`::
+  Name of the function in which the log statement was executed.
+
+`lineno`::
+  Line number at which the log statement was executed.
+
+`int_loglevel`::
+  Log level integer value.
+
+`thread`::
+  ID of the Python thread in which the log statement was executed.
+
+`threadName`::
+  Name of the Python thread in which the log statement was executed.
+
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of Python log levels
 You can use the opt:lttng-enable-event(1):--loglevel or
 opt:lttng-enable-event(1):--loglevel-only option of the
 man:lttng-enable-event(1) command to target a range of Python log levels
@@ -4844,15 +4804,15 @@ mostly to instrument shell scripts:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-echo "Some message, some $variable" > /proc/lttng-logger
+$ echo "Some message, some $variable" > /proc/lttng-logger
 ----
 
 Any event that the LTTng logger emits is named `lttng_logger` and
 belongs to the Linux kernel <<domain,tracing domain>>. However, unlike
 other instrumentation points in the kernel tracing domain, **any Unix
 user** can <<enabling-disabling-events,create an event rule>> which
 ----
 
 Any event that the LTTng logger emits is named `lttng_logger` and
 belongs to the Linux kernel <<domain,tracing domain>>. However, unlike
 other instrumentation points in the kernel tracing domain, **any Unix
 user** can <<enabling-disabling-events,create an event rule>> which
-matches its event name, not only the root user or users in the tracing
-group.
+matches its event name, not only the root user or users in the
+<<tracing-group,tracing group>>.
 
 To use the LTTng logger:
 
 
 To use the LTTng logger:
 
@@ -4890,16 +4850,16 @@ df --human-readable --print-type / > /proc/lttng-logger
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng create
-lttng enable-event --kernel lttng_logger
-lttng start
+$ lttng create
+$ lttng enable-event --kernel lttng_logger
+$ lttng start
 ----
 
 Run the Bash script:
 
 [role="term"]
 ----
 ----
 
 Run the Bash script:
 
 [role="term"]
 ----
-bash test.bash
+$ bash test.bash
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the recorded
 ----
 
 <<basic-tracing-session-control,Stop tracing>> and inspect the recorded
@@ -4907,8 +4867,8 @@ events:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng stop
-lttng view
+$ lttng stop
+$ lttng view
 ----
 ====
 
 ----
 ====
 
@@ -4979,7 +4939,7 @@ is your subsystem's name.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-cd $(mktemp -d) &&
+$ cd $(mktemp -d) &&
 wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.9.tar.bz2 &&
 tar -xf lttng-modules-latest-2.9.tar.bz2 &&
 cd lttng-modules-2.9.*
 wget http://lttng.org/files/lttng-modules/lttng-modules-latest-2.9.tar.bz2 &&
 tar -xf lttng-modules-latest-2.9.tar.bz2 &&
 cd lttng-modules-2.9.*
@@ -5071,12 +5031,12 @@ MODULE_VERSION(__stringify(LTTNG_MODULES_MAJOR_VERSION) "."
 ----
 --
 
 ----
 --
 
-. Edit path:{probes/Makefile} and add your new kernel module object
+. Edit path:{probes/KBuild} and add your new kernel module object
   next to the existing ones:
 +
 --
 [source,make]
   next to the existing ones:
 +
 --
 [source,make]
-.path:{probes/Makefile}
+.path:{probes/KBuild}
 ----
 # ...
 
 ----
 # ...
 
@@ -5094,8 +5054,8 @@ obj-m += lttng-probe-my-subsys.o
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-make KERNELDIR=/path/to/linux
-sudo make modules_install
+$ make KERNELDIR=/path/to/linux
+# make modules_install && depmod -a
 ----
 --
 +
 ----
 --
 +
@@ -5212,7 +5172,7 @@ module:
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-sudo lttng-sessiond --extra-kmod-probes=my_subsys,usb
+# lttng-sessiond --extra-kmod-probes=my_subsys,usb
 ----
 ====
 --
 ----
 ====
 --
@@ -5230,7 +5190,7 @@ To load _only_ a given custom probe kernel module:
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-sudo lttng-sessiond --kmod-probes=my_subsys,usb
+# lttng-sessiond --kmod-probes=my_subsys,usb
 ----
 ====
 --
 ----
 ====
 --
@@ -5242,7 +5202,7 @@ To confirm that a probe module is loaded:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lsmod | grep lttng_probe_usb
+$ lsmod | grep lttng_probe_usb
 ----
 --
 
 ----
 --
 
@@ -5253,7 +5213,7 @@ To unload the loaded probe modules:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-sudo pkill lttng-sessiond
+# pkill lttng-sessiond
 ----
 --
 +
 ----
 --
 +
@@ -5315,7 +5275,7 @@ To start a user session daemon:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng-sessiond --daemonize
+$ lttng-sessiond --daemonize
 ----
 --
 
 ----
 --
 
@@ -5326,7 +5286,7 @@ To start the root session daemon:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-sudo lttng-sessiond --daemonize
+# lttng-sessiond --daemonize
 ----
 --
 
 ----
 --
 
@@ -5355,7 +5315,7 @@ To create a tracing session with a generated name:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create
+$ lttng create
 ----
 --
 
 ----
 --
 
@@ -5369,7 +5329,7 @@ To create a tracing session with a specific name:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create my-session
+$ lttng create my-session
 ----
 --
 +
 ----
 --
 +
@@ -5389,7 +5349,7 @@ To output LTTng traces to a non-default location:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create --output=/tmp/some-directory my-session
+$ lttng create my-session --output=/tmp/some-directory
 ----
 --
 
 ----
 --
 
@@ -5402,7 +5362,7 @@ To list all the existing tracing sessions for your Unix user:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng list
+$ lttng list
 ----
 --
 
 ----
 --
 
@@ -5434,7 +5394,7 @@ To change the current tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng set-session new-session
+$ lttng set-session new-session
 ----
 --
 +
 ----
 --
 +
@@ -5452,7 +5412,7 @@ To destroy the current tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng destroy
+$ lttng destroy
 ----
 --
 
 ----
 --
 
@@ -5489,7 +5449,7 @@ To list the available instrumentation points:
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng list --userspace
+$ lttng list --userspace
 ----
 ====
 
 ----
 ====
 
@@ -5497,7 +5457,7 @@ lttng list --userspace
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng list --kernel --syscall
+$ lttng list --kernel --syscall
 ----
 ====
 
 ----
 ====
 
@@ -5601,7 +5561,7 @@ command-line options to create simple to more complex event rules.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --kernel sched_switch
+$ lttng enable-event --kernel sched_switch
 ----
 ====
 
 ----
 ====
 
@@ -5609,7 +5569,7 @@ lttng enable-event --kernel sched_switch
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --kernel --syscall open,write,read,close
+$ lttng enable-event --kernel --syscall open,write,read,close
 ----
 ====
 
 ----
 ====
 
@@ -5617,18 +5577,18 @@ lttng enable-event --kernel --syscall open,write,read,close
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --kernel sched_switch --filter='prev_comm == "bash"'
+$ lttng enable-event --kernel sched_switch --filter='prev_comm == "bash"'
 ----
 
 [role="term"]
 ----
 ----
 
 [role="term"]
 ----
-lttng enable-event --kernel --all \
+$ lttng enable-event --kernel --all \
                    --filter='$ctx.tid == 1988 || $ctx.tid == 1534'
 ----
 
 [role="term"]
 ----
                    --filter='$ctx.tid == 1988 || $ctx.tid == 1534'
 ----
 
 [role="term"]
 ----
-lttng enable-event --jul my_logger \
+$ lttng enable-event --jul my_logger \
                    --filter='$app.retriever:cur_msg_id > 3'
 ----
 
                    --filter='$app.retriever:cur_msg_id > 3'
 ----
 
@@ -5640,7 +5600,7 @@ use man:lttng(1) from a shell.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --userspace my_app:'*' --loglevel=TRACE_INFO
+$ lttng enable-event --userspace my_app:'*' --loglevel=TRACE_INFO
 ----
 
 IMPORTANT: Make sure to always quote the wildcard character when you
 ----
 
 IMPORTANT: Make sure to always quote the wildcard character when you
@@ -5651,7 +5611,7 @@ use man:lttng(1) from a shell.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --python my-app.'*' \
+$ lttng enable-event --python my-app.'*' \
                    --exclude='my-app.module,my-app.hello'
 ----
 ====
                    --exclude='my-app.module,my-app.hello'
 ----
 ====
@@ -5660,7 +5620,7 @@ lttng enable-event --python my-app.'*' \
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --log4j --all --loglevel-only=LOG4J_WARN
+$ lttng enable-event --log4j --all --loglevel-only=LOG4J_WARN
 ----
 ====
 
 ----
 ====
 
@@ -5668,7 +5628,7 @@ lttng enable-event --log4j --all --loglevel-only=LOG4J_WARN
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-event --userspace my_app:my_tracepoint --channel=my-channel
+$ lttng enable-event --userspace my_app:my_tracepoint --channel=my-channel
 ----
 ====
 
 ----
 ====
 
@@ -5680,8 +5640,8 @@ rules:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng enable-event --userspace my_app:my_tracepoint
-lttng enable-event --userspace my_app:my_tracepoint \
+$ lttng enable-event --userspace my_app:my_tracepoint
+$ lttng enable-event --userspace my_app:my_tracepoint \
                    --loglevel=TRACE_INFO
 ----
 
                    --loglevel=TRACE_INFO
 ----
 
@@ -5705,7 +5665,7 @@ a _disabled_ event rule.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng disable-event --python my-logger
+$ lttng disable-event --python my-logger
 ----
 ====
 
 ----
 ====
 
@@ -5713,7 +5673,7 @@ lttng disable-event --python my-logger
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng disable-event --jul '*'
+$ lttng disable-event --jul '*'
 ----
 ====
 
 ----
 ====
 
@@ -5726,7 +5686,7 @@ rules of a given channel.
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng disable-event --jul --all-events
+$ lttng disable-event --jul --all-events
 ----
 ====
 
 ----
 ====
 
@@ -5744,7 +5704,7 @@ parameters, its channels, event rules, and their attributes:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng status
+$ lttng status
 ----
 --
 +
 ----
 --
 +
@@ -5756,7 +5716,7 @@ To get the status of any tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng list my-session
+$ lttng list my-session
 ----
 --
 +
 ----
 --
 +
@@ -5778,7 +5738,7 @@ To start tracing in the current tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng start
+$ lttng start
 ----
 --
 
 ----
 --
 
@@ -5794,7 +5754,7 @@ To stop tracing in the current tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng stop
+$ lttng stop
 ----
 --
 +
 ----
 --
 +
@@ -5919,7 +5879,7 @@ command-line options to create simple to more complex channels.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-channel --kernel my-channel
+$ lttng enable-channel --kernel my-channel
 ----
 ====
 
 ----
 ====
 
@@ -5927,7 +5887,7 @@ lttng enable-channel --kernel my-channel
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-channel --userspace --num-subbuf=4 --subbuf-size=1M \
+$ lttng enable-channel --userspace --num-subbuf=4 --subbuf-size=1M \
                      --buffers-pid my-channel
 ----
 ====
                      --buffers-pid my-channel
 ----
 ====
@@ -5936,7 +5896,7 @@ lttng enable-channel --userspace --num-subbuf=4 --subbuf-size=1M \
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-channel --kernel --tracefile-count=8 \
+$ lttng enable-channel --kernel --tracefile-count=8 \
                      --tracefile-size=4194304 my-channel
 ----
 ====
                      --tracefile-size=4194304 my-channel
 ----
 ====
@@ -5945,7 +5905,7 @@ lttng enable-channel --kernel --tracefile-count=8 \
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng enable-channel --userspace --overwrite my-channel
+$ lttng enable-channel --userspace --overwrite my-channel
 ----
 ====
 
 ----
 ====
 
@@ -5954,8 +5914,8 @@ two different channels:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng enable-event --userspace --channel=my-channel app:tp
-lttng enable-event --userspace --channel=other-channel app:tp
+$ lttng enable-event --userspace --channel=my-channel app:tp
+$ lttng enable-event --userspace --channel=other-channel app:tp
 ----
 
 If both channels are enabled, when a tracepoint named `app:tp` is
 ----
 
 If both channels are enabled, when a tracepoint named `app:tp` is
@@ -5972,7 +5932,7 @@ previously, use the man:lttng-disable-channel(1) command.
 ====
 [role="term"]
 ----
 ====
 [role="term"]
 ----
-lttng disable-channel --kernel my-channel
+$ lttng disable-channel --kernel my-channel
 ----
 ====
 
 ----
 ====
 
@@ -6020,7 +5980,7 @@ of the current tracing session.
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng add-context --userspace --type=vpid --type=perf:thread:cpu-cycles
+$ lttng add-context --userspace --type=vpid --type=perf:thread:cpu-cycles
 ----
 ====
 
 ----
 ====
 
@@ -6032,8 +5992,8 @@ man:perf-record(1).
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng add-context --userspace --type=perf:thread:raw:r0110:test
-lttng add-context --kernel --type=perf:cpu:raw:r0013c:x86unhalted
+$ lttng add-context --userspace --type=perf:thread:raw:r0110:test
+$ lttng add-context --kernel --type=perf:cpu:raw:r0013c:x86unhalted
 ----
 ====
 
 ----
 ====
 
@@ -6045,7 +6005,7 @@ tracing session.
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng add-context --kernel --channel=my-channel --type=tid
+$ lttng add-context --kernel --channel=my-channel --type=tid
 ----
 ====
 
 ----
 ====
 
@@ -6058,7 +6018,7 @@ in the channel named `my-channel`:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng add-context --kernel --channel=my-channel \
+$ lttng add-context --kernel --channel=my-channel \
                   --type='$app:retriever:cur_msg_id'
 ----
 
                   --type='$app:retriever:cur_msg_id'
 ----
 
@@ -6107,7 +6067,7 @@ tracks the specific PIDs. After:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng track --pid=3,4,7,10,13
+$ lttng track --pid=3,4,7,10,13
 ----
 
 the whitelist is:
 ----
 
 the whitelist is:
@@ -6120,7 +6080,7 @@ You can add more PIDs to the whitelist afterwards:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng track --pid=1,15,16
+$ lttng track --pid=1,15,16
 ----
 
 The result is:
 ----
 
 The result is:
@@ -6134,7 +6094,7 @@ whitelist. Given the previous example, the following command:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng untrack --pid=3,7,10,13
+$ lttng untrack --pid=3,7,10,13
 ----
 
 leads to this whitelist:
 ----
 
 leads to this whitelist:
@@ -6143,12 +6103,12 @@ leads to this whitelist:
 .PIDs 3, 7, 10, and 13 are removed from the whitelist.
 image::track-1-4-15-16.png[]
 
 .PIDs 3, 7, 10, and 13 are removed from the whitelist.
 image::track-1-4-15-16.png[]
 
-LTTng can track all possible PIDs again using the opt:track(1):--all
-option:
+LTTng can track all possible PIDs again using the
+opt:lttng-track(1):--all option:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng track --pid --all
+$ lttng track --pid --all
 ----
 
 The result is, again:
 ----
 
 The result is, again:
@@ -6169,7 +6129,7 @@ man:lttng-untrack(1) command to clear the whitelist after you
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng untrack --pid --all
+$ lttng untrack --pid --all
 ----
 
 gives:
 ----
 
 gives:
@@ -6185,7 +6145,7 @@ specific PIDs, for example:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng track --pid=6,11
+$ lttng track --pid=6,11
 ----
 
 Result:
 ----
 
 Result:
@@ -6223,7 +6183,7 @@ To save a given tracing session configuration:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng save my-session
+$ lttng save my-session
 ----
 --
 +
 ----
 --
 +
@@ -6250,7 +6210,7 @@ To load a tracing session:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng load my-session
+$ lttng load my-session
 ----
 --
 +
 ----
 --
 +
@@ -6278,7 +6238,7 @@ To send the trace data over the network:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng-relayd
+$ lttng-relayd
 ----
 --
 
 ----
 --
 
@@ -6288,7 +6248,7 @@ lttng-relayd
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create my-session --set-url=net://remote-system
+$ lttng create my-session --set-url=net://remote-system
 ----
 --
 +
 ----
 --
 +
@@ -6297,7 +6257,7 @@ remote system. See man:lttng-create(1) for the exact URL format.
 
 . On the target system, use the man:lttng(1) command-line tool as usual.
   When tracing is active, the target's consumer daemon sends sub-buffers
 
 . On the target system, use the man:lttng(1) command-line tool as usual.
   When tracing is active, the target's consumer daemon sends sub-buffers
-  to the relay daemon running on the remote system intead of flushing
+  to the relay daemon running on the remote system instead of flushing
   them to the local file system. The relay daemon writes the received
   packets to the local file system.
 
   them to the local file system. The relay daemon writes the received
   packets to the local file system.
 
@@ -6334,7 +6294,7 @@ To use LTTng live:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create --live my-session
+$ lttng create my-session --live
 ----
 --
 +
 ----
 --
 +
@@ -6346,7 +6306,8 @@ This spawns a local relay daemon.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-babeltrace --input-format=lttng-live net://localhost/host/hostname/my-session
+$ babeltrace --input-format=lttng-live \
+           net://localhost/host/hostname/my-session
 ----
 --
 +
 ----
 --
 +
@@ -6364,7 +6325,7 @@ You can list the available live tracing sessions with Babeltrace:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-babeltrace --input-format=lttng-live net://localhost
+$ babeltrace --input-format=lttng-live net://localhost
 ----
 
 You can start the relay daemon on another system. In this case, you need
 ----
 
 You can start the relay daemon on another system. In this case, you need
@@ -6401,7 +6362,7 @@ To take a snapshot:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create --snapshot my-session
+$ lttng create my-session --snapshot
 ----
 --
 +
 ----
 --
 +
@@ -6424,7 +6385,7 @@ change before you actually take the snapshot.
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng snapshot record --name=my-first-snapshot
+$ lttng snapshot record --name=my-first-snapshot
 ----
 --
 +
 ----
 --
 +
@@ -6462,7 +6423,7 @@ XML machine interface output, for example:
 
 [role="term"]
 ----
 
 [role="term"]
 ----
-lttng --mi=xml enable-event --kernel --syscall open
+$ lttng --mi=xml enable-event --kernel --syscall open
 ----
 
 A schema definition (XSD) is
 ----
 
 A schema definition (XSD) is
@@ -6498,7 +6459,7 @@ To regenerate the metadata of an LTTng trace:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng regenerate metadata
+$ lttng regenerate metadata
 ----
 --
 
 ----
 --
 
@@ -6541,7 +6502,7 @@ create it in snapshot mode, before you take a snapshot:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng regenerate statedump
+$ lttng regenerate statedump
 ----
 --
 
 ----
 --
 
@@ -6550,7 +6511,7 @@ lttng regenerate statedump
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng stop
+$ lttng stop
 ----
 --
 
 ----
 --
 
@@ -6559,7 +6520,7 @@ lttng stop
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng snapshot record --name=my-snapshot
+$ lttng snapshot record --name=my-snapshot
 ----
 --
 
 ----
 --
 
@@ -6604,7 +6565,7 @@ trace data after a system crash:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng create --shm-path=/path/to/shm
+$ lttng create my-session --shm-path=/path/to/shm
 ----
 --
 
 ----
 --
 
@@ -6617,7 +6578,7 @@ lttng create --shm-path=/path/to/shm
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng-crash /path/to/shm
+$ lttng-crash /path/to/shm
 ----
 --
 
 ----
 --
 
@@ -6632,7 +6593,7 @@ To convert the ring buffer files to LTTng trace files:
 --
 [role="term"]
 ----
 --
 [role="term"]
 ----
-lttng-crash --extract=/path/to/trace /path/to/shm
+$ lttng-crash --extract=/path/to/trace /path/to/shm
 ----
 --
 
 ----
 --
 
@@ -7097,7 +7058,7 @@ event::
   or a Linux kernel KProbe.
 +
 An event is said to _occur_ at a specific time. Different actions can
   or a Linux kernel KProbe.
 +
 An event is said to _occur_ at a specific time. Different actions can
-be taken upon the occurance of an event, like record the event's payload
+be taken upon the occurrence of an event, like record the event's payload
 to a sub-buffer.
 
 <<channel-overwrite-mode-vs-discard-mode,event loss mode>>::
 to a sub-buffer.
 
 <<channel-overwrite-mode-vs-discard-mode,event loss mode>>::
@@ -7268,7 +7229,7 @@ tracer::
 <<domain,tracing domain>>::
   A namespace for event sources.
 
 <<domain,tracing domain>>::
   A namespace for event sources.
 
-tracing group::
+<<tracing-group,tracing group>>::
   The Unix group in which a Unix user can be to be allowed to trace the
   Linux kernel.
 
   The Unix group in which a Unix user can be to be allowed to trace the
   Linux kernel.
 
Unnamed repository; edit this file 'description' to name the repository.
This page took 0.054974 seconds and 4 git commands to generate.