X-Git-Url: http://git.efficios.com/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=089d87fa09861188d8e38551b1c4fde7b54829cf;hp=654be5ef5ee360ecd1879c96694bd37238b2e09f;hb=478510441d784434ce1d16af9f4f7c10269b78dd;hpb=b883c01b402d1fcb625740103804861f063ec6b0 diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 654be5ef5..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]" @@ -639,6 +664,15 @@ Tracing already started .IP "81" Tracing already stopped + +.IP "98" +No UST consumer detected + +.IP "99" +No Kernel consumer detected + +.IP "100" +Event already enabled with different loglevel .PP .SH "ENVIRONMENT VARIABLES" @@ -647,7 +681,7 @@ Note that all command line options override environment variables. .PP .PP -.IP "LTTNG_SESSIOND_PATH_ENV" +.IP "LTTNG_SESSIOND_PATH" Allows one to specify the full session daemon binary path to lttng command line tool. You can also use \-\-sessiond-path option having the same effect. .SH "SEE ALSO"