common: move copy_filter_bytecode to bytecode.c and rename it

[lttng-tools.git] / doc / man / lttng-add-context.1.txt

diff --git a/doc/man/lttng-add-context.1.txt b/doc/man/lttng-add-context.1.txt
index fe2412e30c993f9ce739489872c1802fecf95aa4..640da1db1309dda5c81c466dc78a994e01cacc41 100644 (file)
--- a/doc/man/lttng-add-context.1.txt
+++ b/doc/man/lttng-add-context.1.txt
@@ -1,5 +1,6 @@
 lttng-add-context(1)
 ====================
 lttng-add-context(1)
 ====================

+:revdate: 5 Februrary 2018

 
 
 NAME
 
 
 NAME


@@ -46,13 +47,17 @@ 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
 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.
+`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:
 
 Application-specific context fields can be added to a channel using the
 following syntax:


@@ -75,6 +80,8 @@ most shells.
 Use the option:--list option without other arguments to list the
 available context field names.
 
 Use the option:--list option without other arguments to list the
 available context field names.
 

+See the <<limitations,LIMITATIONS>> section below for a list of
+limitations to consider.

 
 include::common-cmd-options-head.txt[]
 
 
 include::common-cmd-options-head.txt[]
 


@@ -119,6 +126,12 @@ option:-t 'TYPE', option:--type='TYPE'::
 
 include::common-cmd-help-options.txt[]
 
 
 include::common-cmd-help-options.txt[]
 

+[[limitations]]
+LIMITATIONS
+-----------
+As of this version of LTTng, it is not possible to add context fields to
+a channel once its tracing session has been started (see man:lttng-start(1))
+at least once.

 
 include::common-cmd-footer.txt[]
 
 
 include::common-cmd-footer.txt[]