Commit | Line | Data |
---|---|---|
c23b8cb1 PP |
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 | |
47bfcb75 | 7 | have a hard time. |
c23b8cb1 PP |
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> |