X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng-sessiond.8;h=ee355fe1af526a8d5cfe83a601b459ec315c518c;hb=72dd74910ee17be5d82c6b2286f454942bf19d24;hp=00656d21a45a9b66a3af5a5cee8e7788f79276ea;hpb=fa072eae902cbc001ec8406d52a3a6903eb77441;p=lttng-tools.git diff --git a/doc/man/lttng-sessiond.8 b/doc/man/lttng-sessiond.8 index 00656d21a..ee355fe1a 100644 --- a/doc/man/lttng-sessiond.8 +++ b/doc/man/lttng-sessiond.8 @@ -1,7 +1,7 @@ .TH "LTTNG-SESSIOND" "8" "January 31, 2012" "" "" .SH "NAME" -lttng-sessiond \(em LTTng 2.0 central tracing registry session daemon. +lttng-sessiond \(em LTTng 2.x central tracing registry session daemon. .SH "SYNOPSIS" @@ -20,7 +20,7 @@ systems is also possible. The session daemon, acting as a tracing registry, allow you to interact with multiple tracers (kernel and user-space) inside the same container, a tracing session. Trace can be gathered from the kernel and/or instrumented applications -(lttng-ust(3)). Aggregating those traces is done using a viewer, like the +(lttng-ust(3)). Aggregating those traces is done using a viewer, like the babeltrace(1) text viewer. In order to trace the kernel, the session daemon needs to be running as root. @@ -56,6 +56,9 @@ Verbose mode for consumer. Activate DBG() macro. .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 @@ -63,7 +66,7 @@ Specify the tracing group name. (default: tracing) Show version number .TP .BR "-S, --sig-parent" -Send SIGCHLD to parent pid to notify readiness. +Send SIGUSR1 to parent pid to notify readiness. This is used by \fBlttng(1)\fP to get notified when the session daemon is ready to accept command. When building a third party tool over liblttng-ctl, this option @@ -132,11 +135,34 @@ Specifiy the 32-bit library path containing libconsumer.so. .IP "LTTNG_DEBUG_NOCLONE" Debug-mode disabling use of clone/fork. Insecure, but required to allow debuggers to work with sessiond on some operating systems. +.IP "LTTNG_APP_SOCKET_TIMEOUT" +Control the timeout of application's socket when sending and receiving +commands. Takes an integer parameter: the timeout value, in seconds. +After this period of time, the application is unregistered by the +session daemon. A value of 0 or -1 means an infinite timeout. Default +value is 5 seconds. +.IP "LTTNG_NETWORK_SOCKET_TIMEOUT" +Control timeout of socket connection, receive and send. Takes an integer +parameter: the timeout value, in milliseconds. A value of 0 or -1 uses +the timeout of the operating system (this is the default). .SH "SEE ALSO" .PP babeltrace(1), lttng-ust(3), lttng(1) .PP + +.SH "LIMITATIONS" + +.PP +For unprivileged user running lttng-sessiond, the maximum number of file +descriptors per process is usually 1024. This limits the number of traceable +applications since for each instrumented application there is two file +descriptors per-CPU and one more socktet for bidirectional communication. + +For the root user, the limit is bumped to 65535. Future version will deal with +this limitation. +.PP + .SH "BUGS" .PP @@ -163,8 +189,8 @@ You can find us on IRC server irc.oftc.net (OFTC) in #lttng. .PP Thanks to Yannick Brosseau without whom this project would never have been so -lean and mean! Also thanks to the Ericsson teams working on tracing which -helped us greatly with detailed bug reports and unusual test cases. +lean and mean! Also thanks to the Ericsson teams working on tracing which helped +us greatly with detailed bug reports and unusual test cases. Thanks to our beloved packager Alexandre Montplaisir-Goncalves (Ubuntu and PPA maintainer) and Jon Bernard for our Debian packages.