X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=089d87fa09861188d8e38551b1c4fde7b54829cf;hp=f13d5d341d608b8e6a3c77106bf5e9be9e5ff235;hb=9bd578f50a1e2438c40ca10789ca90d63c8f8829;hpb=5c827ce0dce140b121032837510f89cb70d1650d diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index f13d5d341..089d87fa0 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -1,4 +1,4 @@ -.TH "LTTNG" "1" "February 9, 2012" "" "" +.TH "LTTNG" "1" "July 17, 2012" "" "" .SH "NAME" lttng \(em LTTng 2.0 tracer control command line tool @@ -239,6 +239,8 @@ If NAME is omitted, the session name is taken from the .lttngrc file. .nf \-h, \-\-help Show summary of possible options and commands. +\-a, \-\-all + Destroy all sessions \-\-list-options Simple listing of options .fi @@ -338,6 +340,29 @@ file. Enabling syscalls tracing (kernel tracer), you will not be able to disable them with disable-event. This is a known limitation. You can disable the entire channel to do the trick. + +\-\-filter 'expression' + Set a filter on a newly enabled event. + Filter expression on event fields, event recording + depends on evaluation. Only specify on first activation + of a given event within a session. Filter only allowed + when enabling events within a session before tracing is + started. If the filter fails to link with the event + within the traced domain, the event will be discarded. + Currently, filter is only implemented for the user-space + tracer. + Expression examples: + + 'intfield > 500 && intfield < 503' + '(stringfield == "test" || intfield != 10) && intfield > 33' + 'doublefield > 1.1 && intfield < 5.3' + + Wildcards are allowed at the end of strings: + 'seqfield1 == "te*"' + In string literals, the escape character is a '\\'. + Use '\\*' for the '*' character, and '\\\\' for the + '\\' character. + .fi .IP "\fBdisable-channel\fP NAME[,NAME2,...] [\-k|\-u] [OPTIONS]" @@ -645,6 +670,9 @@ No UST consumer detected .IP "99" No Kernel consumer detected + +.IP "100" +Event already enabled with different loglevel .PP .SH "ENVIRONMENT VARIABLES"