X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-add-context.1.txt;h=e3c8813b5ce13466a70511198f0a428e77eedebe;hp=529a7da26478f15891d002c29e666ad29b7bbd48;hb=deb35f495e89dd75b7fef7ffe46dc2301bd29c69;hpb=d1cff33724d92f0637853acb81d694532fb97b4b diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt index 529a7da26..e3c8813b5 100644 --- a/doc/man/lttng-add-context.1.txt +++ b/doc/man/lttng-add-context.1.txt @@ -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,19 @@ 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:rN:NAME` (Linux kernel tracing domain) or +`perf:thread:raw:rN:NAME` (user space tracing domain), with: + +`N`:: + A hexadecimal event descriptor which is the same format as used + by man:perf-record(1): a concatenation of the event number and umask + value provided by the processor's manufacturer. The possible values + for this field are processor-specific. + +`NAME`:: + Custom name to easily recognize the counter. + Application-specific context fields can be added to a channel using the following syntax: @@ -89,11 +102,11 @@ option:-u, option:--userspace:: 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. @@ -103,7 +116,7 @@ Context 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. @@ -116,4 +129,4 @@ include::common-cmd-footer.txt[] SEE ALSO -------- -linklttng:lttng(1) +man:lttng(1)