X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=bd2776114f597df6ec3983990a1a2eaacf239cee;hb=e85eccc8d6ec0064d723a08260f23936e8143e2e;hp=cdd816d9d98f93919f3bbd06512d81a3b8c7d145;hpb=09af934156184110c2e04512112212432089ab80;p=lttng-tools.git diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index cdd816d9d..bd2776114 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -590,11 +590,7 @@ Dynamic function entry/return probe. Addr and offset can be octal (0NNN...), decimal (NNN...) or hexadecimal (0xNNN...) .TP .BR "\-\-syscall" -System call event. 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. Also note -that per-syscall selection is not supported yet. Use with "-a" to enable -all syscalls. +System call event. .TP .BR "\-\-filter 'expression'" Set a filter on a newly enabled event. Filter expression on event @@ -611,6 +607,7 @@ Expression examples: 'intfield > 500 && intfield < 503' '(strfield == "test" || intfield != 10) && intfield > 33' 'doublefield > 1.1 && intfield < 5.3' + 'enumfield == 1234' .fi Wildcards are allowed at the end of strings: @@ -618,7 +615,8 @@ Wildcards are allowed at the end of strings: In string literals, the escape character is a '\\'. Use '\\*' for the '*' character, and '\\\\' for the '\\' character sequence. Wildcard matches any sequence of characters, including an empty sub-string -(matches 0 or more characters). +(matches 0 or more characters). Enumeration fields can currently only be +compared as integers. Context information can be used for filtering. The examples below shows usage of context filtering on the process name (using a wildcard), process ID @@ -681,7 +679,7 @@ Apply for the user-space tracer .PP .PP -\fBdisable-event\fP NAME[,NAME2,...] (\-k | \-u) [OPTIONS] +\fBdisable-event\fP NAME[,NAME2,...] (\-k | \-u | \-j | \-l | \-p) [TYPE] [OPTIONS] .RS Disable tracing event @@ -711,8 +709,8 @@ Apply on session name Apply on channel name .TP .BR "\-a, \-\-all-events" -Disable all events. This does NOT disable "*" but rather every known -events of the session. +Disable all events. This does NOT ONLY disable "*" but rather every known +events of the session .TP .BR "\-k, \-\-kernel" Apply for the kernel tracer @@ -727,7 +725,26 @@ Apply for Java application using Java Util Logging interface (JUL) Apply for Java application using LOG4J .TP .BR "\-p, \-\-python" -Apply for Python application using the logging module. +Apply for Python application using the logging module + +.TP +.B TYPE (kernel domain only): + +.TP +.BR "\-\-all" +Disable event of all type +.TP +.BR "\-\-tracepoint" +Disable event of type tracepoint +.TP +.BR "\-\-syscall" +Disable event of type syscall +.TP +.BR "\-\-probe" +Disable event of type probe +.TP +.BR "\-\-function" +Disable event of type function .RE .PP @@ -831,6 +848,31 @@ already exists. .RE .PP +.PP +\fBmetadata\fP [OPTIONS] ACTION +.RS +Metadata command for a LTTng session. + +.B OPTIONS: + +.TP +.BR "\-h, \-\-help" +Show summary of possible options and commands. +.TP +.BR "\-\-list-options" +Simple listing of options + +.PP +.B ACTION: + +.TP +\fBregenerate\fP [-s ] +Regenerate the metadata of a session. This allows the user to regenerate the +metadata after a major NTP correction and that way update the clock offset from +epoch in the metadata. Only works on kernel, UST per-uid and non-live sessions. +.RE +.PP + .PP \fBsave\fP [OPTIONS] [SESSION] .RS