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.
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:
Target
~~~~~~
-option:-c, option:--channel='CHANNEL'::
+option:-c 'CHANNEL', option:--channel='CHANNEL'::
Add context fields to a channel named 'CHANNEL' instead of adding
them to all the channels.
-option:-s, option:--session='SESSION'::
+option:-s 'SESSION', option:--session='SESSION'::
Add context fields to a channel in the tracing session named 'SESSION'
instead of the current tracing session.
option:--list::
List the available context fields. Use this option alone.
-option:-t, option:--type='TYPE'::
+option:-t 'TYPE', option:--type='TYPE'::
Add context field named 'TYPE'. This option can be repeated as
many times as needed on the command-line.
SEE ALSO
--------
-linklttng:lttng(1)
+man:lttng(1)