contents/using-lttng/controlling-tracing/mi.md

   1 ---
   2 id: mi
   3 ---
   4
   5 The `lttng` tool aims at providing a command output as human-readable as
   6 possible. While this output is easy to parse by a human being, machines
   7 will have a hard time.
   8
   9 This is why the `lttng` tool provides the general `--mi` option, which
  10 must specify a machine interface output format. As of the latest
  11 LTTng stable release, only the `xml` format is supported. A schema
  12 definition (XSD) is made
  13 <a href="https://github.com/lttng/lttng-tools/blob/master/src/common/mi_lttng.xsd" class="ext">available</a>
  14 to ease the integration with external tools as much as possible.
  15
  16 The `--mi` option can be used in conjunction with all `lttng` commands.
  17 Here are some examples:
  18
  19 <pre class="term">
  20 lttng --mi xml create some-session
  21 lttng --mi xml list some-session
  22 lttng --mi xml list --kernel
  23 lttng --mi xml enable-event --kernel --syscall open
  24 lttng --mi xml start
  25 </pre>