X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng.1;h=484b365b4d9787bbf1d6b99e07d7e71c0ff2e52a;hp=e650d24264c27e50b65d59973c26c5935fc69e4f;hb=c2788d695a4b5d9792d9c705caac38b38358bc69;hpb=cea28771668f6fd337d00466ea9f01c12cda7467 diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index e650d2426..484b365b4 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -312,8 +312,8 @@ It is important to note that if a certain type of buffers is used, the session will be set with that type and all other subsequent channel needs to have the same type. -For the kernel tracer (\-k), once the session is started at least once, it's -not possible anymore to enable new channel for that session. +Note that once the session has been started and enabled on the tracer side, +it's not possible anymore to enable a new channel for that session. .fi .B OPTIONS: @@ -595,6 +595,66 @@ Will change the session name in the .lttngrc file. .IP +.IP "\fBsnapshot\fP ACTION" +.nf +Snapshot command for LTTng session. +.fi + +.B OPTIONS: + +.nf +\-h, \-\-help + Show summary of possible options and commands. +\-\-list-options + Simple listing of options +.fi + +.B ACTION: + +.nf +\fBadd-output\fP [-m ] [-s ] [-n ] | -C -D + +Setup and add an snapshot output for a session. Output are the destination +where the snapshot will be sent. Only one output is permitted. To change it, +you'll need to delete it and add back the new one. + +\fBdel-output\fP ID | NAME [-s ] + +Delete an output for a session using the ID. You can either specify the +output's ID that can be found with list-output or the name. + +\fBlist-output\fP [-s ] + +List the output of a session. Attributes of the output are printed. + +\fBrecord\fP [-m ] [-s ] [-n ] [ | -C -D ] + +Snapshot a session's buffer(s) for all domains. If an URL is specified, it is +used instead of a previously added output. Specifying only a name or/and a max +size will override the current output values. For instance, you can record a +snapshot with a custom maximum size or with a different name. + +$ lttng add-output -n mysnapshot file:///data/snapshot +[...] +$ lttng snapshot record -n new_name_snapshot + +The above will create a snapshot in /data/snapshot/new_name_snapshot* directory +rather then in mysnapshot*/ +.fi + +.B LONG OPTIONS + +.nf +\-s, \-\-session NAME Apply to session name. +\-n, \-\-name NAME Name of the snapshot's output. +\-m, \-\-max-size SIZE Maximum size in bytes of the snapshot. + The maxium size does not count the metadata file. +\-C, \-\-ctrl-url URL Set control path URL. (Must use -D also) +\-D, \-\-data-url URL Set data path URL. (Must use -C also) +.fi + +.IP + .IP "\fBstart\fP [NAME] [OPTIONS]" .nf Start tracing