From: Julien Desfossez <jdesfossez@efficios.com>
Date: Mon, 10 Feb 2014 23:50:40 +0000 (-0500)
Subject: LTTng-live usage documentation
X-Git-Tag: v1.2.0-rc1~4
X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=commitdiff_plain;h=c00617c9666237cc6456afb1b8143dfdba9c978d

LTTng-live usage documentation

Signed-off-by: Julien Desfossez <jdesfossez@efficios.com>
Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
---

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 6077f623..782d7d14 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,5 +1,5 @@
 dist_man_MANS = babeltrace.1 babeltrace-log.1
 
-dist_doc_DATA = API.txt
+dist_doc_DATA = API.txt lttng-live.txt
 
 EXTRA_DIST = development.txt
diff --git a/doc/lttng-live.txt b/doc/lttng-live.txt
new file mode 100644
index 00000000..2c2a072a
--- /dev/null
+++ b/doc/lttng-live.txt
@@ -0,0 +1,27 @@
+LTTNG LIVE
+----------
+
+This is a brief howto for using the Babeltrace with LTTng live protocol.
+LTTng live allows the user to read a trace while it is running.
+
+In order to create a live LTTng session, please refer to the LTTng
+documentation (version >= 2.4).
+
+Once the session is created and Babeltrace is installed, you can list the
+sessions with :
+$ babeltrace -i lttng-live net://<your-relayd-hostname>
+
+The output should look like this :
+net://localhost/host/myhostname/mysessionname (timer = 1000000, 5 stream(s), 0 client(s) connected)
+
+It means that the session mysessionname on the host myhostname is currently
+streaming its data to the relayd on localhost.
+
+To attach to this session and start receiving the trace :
+$ babeltrace -i lttng-live net://localhost/host/myhostname/mysessionname
+
+You should now see trace data flowing in your console when events are produced.
+
+To report bugs, please use the same procedure as reporting bugs to Babeltrace,
+but don't forget to add the -v to the commands above to provide enough debug
+information.