| 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 | 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> |