X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fman%2Flttng-enable-event.1.txt;h=eab060cad5d7601f1c5e4581ee60f5775f845285;hb=4ccdbb61116a1ec301328353d18e705221f35ecc;hp=439099b7fb0d2872b4bb2c7afef9a14f34deb4ff;hpb=af1c4164dd7bad940a84c29c2b429d76e3fc0e33;p=lttng-tools.git diff --git a/doc/man/lttng-enable-event.1.txt b/doc/man/lttng-enable-event.1.txt index 439099b7f..eab060cad 100644 --- a/doc/man/lttng-enable-event.1.txt +++ b/doc/man/lttng-enable-event.1.txt @@ -1,6 +1,6 @@ lttng-enable-event(1) ===================== -:revdate: 3 May 2021 +:revdate: 12 May 2021 NAME @@ -24,7 +24,7 @@ created from a dynamic instrumentation point: [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: @@ -395,6 +395,10 @@ An event{nbsp}__E__ satisfies the event payload and context filter 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. @@ -618,7 +622,7 @@ create it. In particular, with the option:--filter='EXPR' option, 'EXPR' must be the exact same string as the one you used on creation. -include::common-cmd-options-head.txt[] +include::common-lttng-cmd-options-head.txt[] Tracing domain @@ -843,12 +847,18 @@ section above. 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-cmd-help-options.txt[] +include::common-lttng-cmd-after-options.txt[] -include::common-cmd-footer.txt[] +include::common-footer.txt[] SEE ALSO