X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-add-context.1.txt;h=a1e0fe78f14035015e00c7bd4185b9f3f7a2b732;hp=c201fa6a60e41c6a76eca0c9c5fbb9a16804abec;hb=240311ba35005ad516e1df0a17c9b15af38e4181;hpb=60f7980c81806587206b495626d3cdc3ac170c6b diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt index c201fa6a6..a1e0fe78f 100644 --- a/doc/man/lttng-add-context.1.txt +++ b/doc/man/lttng-add-context.1.txt @@ -12,7 +12,7 @@ SYNOPSIS Add context fields to a channel: [verse] -*lttng* ['GENERAL OPTIONS'] *add-context* +*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *add-context* (option:--kernel | option:--userspace | option:--jul | option:--log4j) [option:--session='SESSION'] [option:--channel='CHANNEL'] option:--type='TYPE' [option:--type='TYPE']... @@ -20,7 +20,7 @@ Add context fields to a channel: List the available context fields: [verse] -*lttng* ['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:` 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: @@ -116,4 +125,4 @@ include::common-cmd-footer.txt[] SEE ALSO -------- -linklttng:lttng(1) +man:lttng(1)