X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-relayd.8;h=fcde15ef1aa5653dd95283011e052e5db59fe57f;hb=41ed8e47358244890326cb14dfae889ed0adb1ba;hp=045ac7a1095a42ac00b40877caebec2ad33002b0;hpb=094fe907beff2ae08f63225dd0cc1188659f8cf9;p=lttng-tools.git diff --git a/doc/man/lttng-relayd.8 b/doc/man/lttng-relayd.8 index 045ac7a10..fcde15ef1 100644 --- a/doc/man/lttng-relayd.8 +++ b/doc/man/lttng-relayd.8 @@ -1,7 +1,7 @@ .TH "LTTNG-RELAYD" "8" "July 15, 2012" "" "" .SH "NAME" -lttng-relayd \(em LTTng remote trace collection daemon +lttng-relayd \- LTTng remote trace collection daemon .SH "SYNOPSIS" @@ -17,12 +17,18 @@ It's tracers help tracking down performance issues and debugging problems involving multiple concurrent processes and threads. Tracing across multiple systems is also possible. -The relay daemon listens on the network and receives traces streamed by a -remote consumer. This daemon does not require any particular permissions as -long as it can write in the output folder and listen on the ports. +The relay daemon listens by default on all network interfaces to gather +trace data, but only on localhost for viewer connections. This daemon +does not require any particular permissions as long as it can write in +the output folder and listen on the ports. If a user is within a secured +network and/or has proper firewall settings, lttng-relayd can listen to +viewer connections from all network interfaces by specifying '-L +tcp://0.0.0.0:5344'. -Once a trace has been streamed completely, the trace can be processed by any -tool that can process a local LTTng CTF trace. +Traces can be either viewed "live" (as they are produced) by attaching +to the live viewer port using LTTng live protocol, or after tracing has +been stopped. Once a trace has been streamed completely, the trace can +be processed by any tool that can process a local LTTng CTF trace. By default, the relayd outputs the traces in : ~/lttng-traces/hostname/session-name/domain-name @@ -33,14 +39,17 @@ sessiond side. .SH "OPTIONS" .PP -This program follow the usual GNU command line syntax with long options starting with -two dashes. Below is a summary of the available options. +This program follows the usual GNU command line syntax with long options starting +with two dashes. Below is a summary of the available options. .PP .TP .BR "-h, --help" Show summary of possible options and commands .TP +.BR "\-V, \-\-version" +Show version. +.TP .BR "-v, --verbose" Increase verbosity @@ -50,6 +59,12 @@ There is three debugging level which will print on stderr. Maximum verbosity is .BR "-d, --daemonize" Start as a daemon .TP +.BR "-b, --background" +Start as a daemon, keeping console open +.TP +.BR "-g, --group NAME" +Specify the tracing group name. (default: tracing) +.TP .BR "-C, --control-port" Control port URL (tcp://0.0.0.0:5342 is the default) .TP @@ -57,7 +72,7 @@ Control port URL (tcp://0.0.0.0:5342 is the default) Data port URL (tcp://0.0.0.0:5343 is the default) .TP .BR "-L, --live-port URL" -Live view port URL (tcp://0.0.0.0:5344 is the default). +Live view port URL (tcp://localhost:5344 is the default). .TP .BR "-o, --output" Output base directory. Must use an absolute path (~/lttng-traces is the default)