X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=017592c0025a352ea2c29cc100e6f6493be31db0;hb=222e4eab96d2b2752d4b068d7ed0f0d55ae91527;hp=12ca33d6fbcdecc7faa2019c435acae6ea1fe91e;hpb=cf53c06d8c89926284a15f6c27d60cf31761e622;p=lttng-tools.git diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 12ca33d6f..017592c00 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -77,6 +77,26 @@ Simple listing of lttng options. .TP .BR "\-\-list\-commands" Simple listing of lttng commands. +.TP +.BR "\-m, \-\-mi TYPE +Machine interface + +TYPE supported: XML + +Machine interface (MI) mode converts the traditional pretty printing to a +machine output syntax. MI mode provides a format change-resistant way to access +information generated via the lttng command line. + +When using MI mode, the data is printed on \fBstdout\fP. Error and warning are +printed on \fBstderr\fP with the pretty print default format. + +If any errors occur during the execution of a command, the return value of the +command will be different than zero. In this case, lttng does NOT guarantee the +syntax and data validity of the generated MI output. + +For XML output type, a schema definition (XSD) file used for validation can be +found under src/common/mi_lttng.xsd + .SH "COMMANDS" .PP @@ -261,7 +281,7 @@ URL, if one is specified, as the default snapshot output. Every channel will be in overwrite mode and with mmap output (splice not supported). .TP .BR "\-\-live [USEC]" -Set the session exclusively in live mode. The paremeter is the delay in micro +Set the session exclusively in live mode. The parameter is the delay in micro seconds before the data is flushed and streamed. The live mode allows you to stream the trace and view it while it's being recorded by any tracer. For that, you need a lttng-relayd and this session requires a network URL (\-U or @@ -519,6 +539,9 @@ Apply for the user-space tracer .BR "\-j, \-\-jul" Apply for Java application using Java Util Logging interface (JUL) .TP +.BR "\-l, \-\-log4j" +Apply for Java application using LOG4J +.TP .BR "\-\-tracepoint" Tracepoint event (default). Userspace tracer supports wildcards at the end of string. Don't forget to quote to deal with bash expansion. @@ -680,6 +703,9 @@ Apply for the user-space tracer .TP .BR "\-j, \-\-jul" Apply for Java application using Java Util Logging interface (JUL) +.TP +.BR "\-l, \-\-log4j" +Apply for Java application using LOG4J .RE .PP @@ -728,6 +754,9 @@ Select user-space domain. .BR "\-j, \-\-jul" Apply for Java application using JUL .TP +.TP +.BR "\-l, \-\-log4j" +Apply for Java application using LOG4J .BR "\-f, \-\-fields" List event fields @@ -885,7 +914,7 @@ Apply to session name. Name of the snapshot's output. .TP .BR "\-m, \-\-max-size SIZE" -Maximum size in bytes of the snapshot. The maxium size does not include the +Maximum size in bytes of the snapshot. The maximum size does not include the metadata file. Human readable format is accepted: {+k,+M,+G}. For instance, \-\-max-size 5M @@ -1070,7 +1099,7 @@ found. .PP If you encounter any issues or usability problem, please report it on our mailing list to help improve this project or -at https://bugs.lttng.org which is a bugtracker. +at https://bugs.lttng.org which is a bug tracker. .PP .SH "CREDITS"