The `--filter` option of both lttng-enable-event(1) and a common event
rule specification is not available with the Linux kprobe, kretprobe,
and user space probe instrumentation point types.
Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
Change-Id: I2cea488359bbe8ac8494d785fe3282419ee66d46
lttng-enable-event(1)
=====================
lttng-enable-event(1)
=====================
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-event* option:--kernel
(option:--probe='LOC' | option:--function='LOC' | option:--userspace-probe='LOC') 'RECORDNAME'
[verse]
*lttng* ['linkgenoptions:(GENERAL OPTIONS)'] *enable-event* option:--kernel
(option:--probe='LOC' | option:--function='LOC' | option:--userspace-probe='LOC') 'RECORDNAME'
- [option:--filter='EXPR'] [option:--session='SESSION'] [option:--channel='CHANNEL']
+ [option:--session='SESSION'] [option:--channel='CHANNEL']
Create or enable one or more recording event rules to match
user space tracepoint events:
Create or enable one or more recording event rules to match
user space tracepoint events:
condition of a recording event rule if the option:--filter='EXPR'
option is missing or if 'EXPR' is _true_.
condition of a recording event rule if the option:--filter='EXPR'
option is missing or if 'EXPR' is _true_.
+This condition is only meaningful for the LTTng tracepoint and Linux
+system call instrumentation point types: it's always satisfied for other
+types.
+
'EXPR' can contain references to the payload fields of{nbsp}__E__ and
to the current context fields.
'EXPR' can contain references to the payload fields of{nbsp}__E__ and
to the current context fields.
option:-f 'EXPR', option:--filter='EXPR'::
Only match events of which 'EXPR', which can contain references to
event payload and current context fields, is _true_.
option:-f 'EXPR', option:--filter='EXPR'::
Only match events of which 'EXPR', which can contain references to
event payload and current context fields, is _true_.
++
+This option is only available with the option:--tracepoint or
+option:--syscall option.
include::common-lttng-cmd-help-options.txt[]
include::common-lttng-cmd-help-options.txt[]
lttng-event-rule(7)
===================
lttng-event-rule(7)
===================
[verse]
option:--domain=**kernel** option:--type=(**kprobe** | **uprobe**) option:--location='LOC'
[verse]
option:--domain=**kernel** option:--type=(**kprobe** | **uprobe**) option:--location='LOC'
-pass:[[]option:--event-name='EVENTNAME'] [option:--filter='EXPR']
+pass:[[]option:--event-name='EVENTNAME']
Specify an event rule to match user space tracepoint events:
Specify an event rule to match user space tracepoint events:
condition of an event rule if the option:--filter='EXPR' option is
missing or if 'EXPR' is _true_.
condition of an event rule if the option:--filter='EXPR' option is
missing or if 'EXPR' is _true_.
+This condition is only meaningful for the LTTng tracepoint and Linux
+system call instrumentation point types: it's always satisfied for other
+types.
+
'EXPR' can contain references to the payload fields of{nbsp}__E__ and
to the current context fields.
'EXPR' can contain references to the payload fields of{nbsp}__E__ and
to the current context fields.
option:-f 'EXPR', option:--filter='EXPR'::
Only match events of which 'EXPR', which can contain references to
event payload and current context fields, is _true_.
option:-f 'EXPR', option:--filter='EXPR'::
Only match events of which 'EXPR', which can contain references to
event payload and current context fields, is _true_.
++
+This option is only available with the following options:
++
+* option:--type=++tracepoint++
+* option:--type=++syscall++
+* option:--type=++syscall:entry++
+* option:--type=++syscall:exit++
+* option:--type=++syscall:entry+exit++
include::common-footer.txt[]
include::common-footer.txt[]