X-Git-Url: https://git.lttng.org/?a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=12ca33d6fbcdecc7faa2019c435acae6ea1fe91e;hb=f4a088f723845847249e069fea4d0c1b579d5fd1;hp=3c7bbb44bd84bee3fa9ad58f6182832b6a5a5955;hpb=a10f04ad4a2736801231c0e2bc7ad85e5d372904;p=lttng-tools.git diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 3c7bbb44b..12ca33d6f 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -749,8 +749,10 @@ List available domain(s) Load tracing session configuration If NAME is omitted, all session configurations found in both the user's session -configuration directory and the system session configuration directory will be -loaded. +configuration directory (default: ~/.lttng/sessions/) and the system session +configuration directory (default: /etc/lttng/sessions/) will be loaded. Note +that the sessions in the user directory are loaded first and then the system +wide directory are loaded. .B OPTIONS: @@ -762,7 +764,8 @@ Show summary of possible options and commands. Load all session configurations (default). .TP .BR "\-i, \-\-input-path PATH" -Specify the input path for session configurations. +Specify the input path for session configurations. This overrides the default +session configuration directory. .TP .BR "\-f, -\-force" Overwrite current session configuration(s) if a session of the same name @@ -776,8 +779,12 @@ already exists. Save tracing session configuration If SESSION is omitted, all session configurations will be saved to individual -\fB.lttng\fP files under the user's session configuration directory. The -default session configuration file naming scheme is \fBSESSION.lttng\fP. +\fB.lttng\fP files under the user's session configuration directory (default: +~/.lttng/sessions/). The default session configuration file naming scheme is +\fBSESSION.lttng\fP. + +For instance, a user in the tracing group saving a session from a root session +daemon will save it in her/his user directory. .B OPTIONS: @@ -789,7 +796,8 @@ Show summary of possible options and commands. Save all session configurations (default). .TP .BR "\-o, \-\-output-path PATH" -Specify the output path for saved sessions (default: ~/.lttng/sessions/). +Specify the output path for saved sessions. This overrides the default session +configuration directory. .TP .BR "\-f, -\-force" Overwrite session configuration file if session name clashes. @@ -880,6 +888,10 @@ Name of the snapshot's output. Maximum size in bytes of the snapshot. The maxium size does not include the metadata file. Human readable format is accepted: {+k,+M,+G}. For instance, \-\-max-size 5M + +The minimum size of a snapshot is computed by multiplying the total amount of +streams in the session by the largest subbuffer size. This is to ensure +fairness between channels when extracting data. .TP .BR "\-C, \-\-ctrl-url URL" Set control path URL. (Must use -D also)