X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=doc%2Fman%2Flttng-sessiond.8.txt;h=76f9dab12a0b7a782c7578fa2ef0a3af7f78fb38;hb=8c2b6cb2d6ecee4d7d39bdbf04b9cadd18908238;hp=df119e78beff0d79f3b70415536cb92bdce7066d;hpb=ee717bf064ade68f47c763d60c2d534fd9fd0b96;p=lttng-tools.git diff --git a/doc/man/lttng-sessiond.8.txt b/doc/man/lttng-sessiond.8.txt index df119e78b..76f9dab12 100644 --- a/doc/man/lttng-sessiond.8.txt +++ b/doc/man/lttng-sessiond.8.txt @@ -40,8 +40,8 @@ The _LTTng session daemon_ is a tracing registry which allows the user to interact with multiple tracers (kernel and user space) within the same container, a _tracing session_. Traces can be gathered from the Linux kernel and/or from instrumented applications (see -linklttng:lttng-ust(3)). You can aggregate and read the events of LTTng -traces using linklttng:babeltrace(1). +man:lttng-ust(3)). You can aggregate and read the events of LTTng +traces using man:babeltrace(1). To trace the Linux kernel, the session daemon needs to be running as `root`. LTTng uses a _tracing group_ to allow specific users to interact @@ -65,7 +65,7 @@ Loading tracing session configurations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ By default, the LTTng session daemon tries to load tracing session configurations located in the user default directory -`$HOME/.lttng/sessions` and in the system one, `/etc/lttng/sessions`. +`$HOME/.lttng/sessions` and in the system one, +{system_sessions_dir}+. Note that both the directory containing the tracing session configurations and the session daemon binary _must_ have the same UID for the configurations to be automatically loaded. @@ -102,7 +102,7 @@ option:-l, option:--load='PATH':: option:-S, option:--sig-parent:: Send `SIGUSR1` to parent process to notify readiness. + -NOTE: This is used by linklttng:lttng(1) to get notified when the +NOTE: This is used by man:lttng(1) to get notified when the session daemon is ready to accept commands. When building a third party tool on liblttng-ctl, this option can be very handy to synchronize the control tool and the session daemon. @@ -261,6 +261,35 @@ The option:--kmod-probes option overrides this variable. Tracing session configuration XML schema definition (XSD) path. +FILES +----- +`$LTTNG_HOME/.lttng`:: + User LTTng runtime and configuration directory. + +`$LTTNG_HOME/lttng-traces`:: + Default output directory of LTTng traces. This can be overridden + with the nloption:--output option of the man:lttng-create(1) + command. + +`$LTTNG_HOME/.lttng/sessions`:: + Default location of saved user tracing sessions (see + man:lttng-save(1) and man:lttng-load(1)). + ++{system_sessions_dir}+:: + System-wide location of saved tracing sessions + (see man:lttng-save(1) and man:lttng-load(1)). + +`$LTTNG_HOME/.lttng/lttng.conf`:: + Default location of the session daemon configuration file (see the + option:--config option). + ++{system_lttng_conf}+:: + System-wide location of the session daemon configuration file (see + the option:--config option). + +NOTE: `$LTTNG_HOME` defaults to `$HOME` when not explicitly set. + + EXIT STATUS ----------- *0*:: @@ -290,8 +319,8 @@ include::common-footer.txt[] SEE ALSO -------- -linklttng:lttng(1), -linklttng:lttng-relayd(8), -linklttng:lttng-crash(1), -linklttng:lttng-ust(3), -linklttng:babeltrace(1) +man:lttng(1), +man:lttng-relayd(8), +man:lttng-crash(1), +man:lttng-ust(3), +man:babeltrace(1)