X-Git-Url: http://git.efficios.com/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-add-context.1.txt;h=fe2412e30c993f9ce739489872c1802fecf95aa4;hp=f995a7fbe2fd629f1091c68427edc30fc3410db8;hb=59b19c3c82a824b602b4e3cd70e1cb22448fcb9d;hpb=7c1a4458be934fec31aa27a0eb52e4d0b8cb3803 diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt index f995a7fbe..fe2412e30 100644 --- a/doc/man/lttng-add-context.1.txt +++ b/doc/man/lttng-add-context.1.txt @@ -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:` or `perf:thread:raw:r:` format for +the kernel and user-space respectively. `` 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 `` 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: @@ -89,11 +98,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 +112,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.