From 516f6cbe18eb229593a41eef7d0ed2567673d603 Mon Sep 17 00:00:00 2001 From: =?utf8?q?J=C3=A9r=C3=A9mie=20Galarneau?= Date: Tue, 13 May 2014 12:14:10 -0400 Subject: [PATCH] Man: Add load and save sections to the lttng.1 man page MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Jérémie Galarneau Signed-off-by: David Goulet --- doc/man/lttng.1 | 61 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/doc/man/lttng.1 b/doc/man/lttng.1 index 9f95a8a13..ef73b062c 100644 --- a/doc/man/lttng.1 +++ b/doc/man/lttng.1 @@ -1,4 +1,4 @@ -.TH "LTTNG" "1" "February 05th, 2014" "" "" +.TH "LTTNG" "1" "May 13th, 2014" "" "" .SH "NAME" lttng \(em LTTng 2.x tracer control command line tool @@ -735,6 +735,59 @@ List available domain(s) .RE .PP +.PP +\fBload\fP [OPTIONS] [NAME] +.RS +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. + +.B OPTIONS: + +.TP +.BR "\-h, \-\-help" +Show summary of possible options and commands. +.TP +.BR "\-a, \-\-all" +Load all session configurations (default). +.TP +.BR "\-i, \-\-input-path PATH" +Specify the input path for session configurations. +.TP +.BR "\-f, -\-force" +Overwrite current session configuration(s) if a session of the same name +already exists. +.RE +.PP + +.PP +\fBsave\fP [OPTIONS] [SESSION] +.RS +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. + +.B OPTIONS: + +.TP +.BR "\-h, \-\-help" +Show summary of possible options and commands. +.TP +.BR "\-a, \-\-all" +Save all session configurations (default). +.TP +.BR "\-o, \-\-output-path PATH" +Specify the output path for saved sessions (default: ~/.lttng/sessions/). +.TP +.BR "\-f, -\-force" +Overwrite session configuration file if session name clashes. +.RE +.PP + .PP \fBset-session\fP NAME [OPTIONS] .RS @@ -980,6 +1033,12 @@ Allows one to specify the full session daemon binary path to lttng command line tool. You can also use \-\-sessiond-path option having the same effect. .PP +.PP +.IP "LTTNG_SESSION_CONFIG_XSD_PATH" +Set the path in which the \fBsession.xsd\fP session configuration schema may be +found. +.PP + .SH "SEE ALSO" .BR babeltrace(1), .BR lttng-ust(3), -- 2.34.1