lttng-enable-channel(1): remove redundant --discard from synopsis
[lttng-tools.git] / doc / man / lttng-add-context.1.txt
index d9776b7b649f284a46984ffe0de0f1d688ac2d85..a1e0fe78f14035015e00c7bd4185b9f3f7a2b732 100644 (file)
@@ -20,7 +20,7 @@ Add context fields to a channel:
 List the available context fields:
 
 [verse]
-*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-context* --list
+*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-context* option:--list
 
 
 DESCRIPTION
@@ -28,7 +28,7 @@ DESCRIPTION
 The `lttng add-context` command adds one or more context fields to a
 channel.
 
-Channels are created with the linklttng:lttng-enable-channel(1) command.
+Channels are created with the man:lttng-enable-channel(1) command.
 
 When context fields are added to a channel, all the events emitted
 within this channel contain the dynamic values of those context fields.
@@ -45,6 +45,15 @@ per-thread (`perf:thread:` prefix) counters. Currently, per-CPU counters
 can only be used in the Linux kernel tracing domain, while per-thread
 counters can only be used in the user space tracing domain.
 
+It is also possible to enable PMU counters by raw ID using the
+`perf:cpu:raw:r<N>:<name>` or `perf:thread:raw:r<N>:<name>` format for
+the kernel and user-space respectively. `<N>` is a hexadecimal event
+descriptor which is the same format as used by perf-record(1): a
+concatenation of the `Umask value` and `Event number` provided by the
+processor's manufacturer. The possible values for this field are
+processor-specific. The `<name>` field is used to associate a clearer
+name to the counter.
+
 Application-specific context fields can be added to a channel using the
 following syntax:
 
@@ -116,4 +125,4 @@ include::common-cmd-footer.txt[]
 
 SEE ALSO
 --------
-linklttng:lttng(1)
+man:lttng(1)
This page took 0.023035 seconds and 4 git commands to generate.