[lttng-docs.git] / contents / using-lttng / controlling-tracing / mi.md

---
id: mi
---

The `lttng` tool aims at providing a command output as human-readable as
possible. While this output is easy to parse by a human being, machines
have a hard time.

This is why the `lttng` tool provides the general `--mi` option, which
must specify a machine interface output format. As of the latest
LTTng stable release, only the `xml` format is supported. A schema
definition (XSD) is made
<a href="https://github.com/lttng/lttng-tools/blob/master/src/common/mi_lttng.xsd" class="ext">available</a>
to ease the integration with external tools as much as possible.

The `--mi` option can be used in conjunction with all `lttng` commands.
Here are some examples:

<pre class="term">
lttng --mi xml create some-session
lttng --mi xml list some-session
lttng --mi xml list --kernel
lttng --mi xml enable-event --kernel --syscall open
lttng --mi xml start
</pre>
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>