X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=doc%2Fman%2Flttng-create.1.txt;h=14c9b0182f139c86b3418dd0c520e98b5c189469;hp=10d0c0a75db4fdb3590184606fa12c9990fa7047;hb=84f7f408dc560d1cea0ad328e3d6dab32149b0b9;hpb=f87c475639158070c4eeecede46ed46035ac57bd diff --git a/doc/man/lttng-create.1.txt b/doc/man/lttng-create.1.txt index 10d0c0a75..14c9b0182 100644 --- a/doc/man/lttng-create.1.txt +++ b/doc/man/lttng-create.1.txt @@ -69,7 +69,7 @@ Creation modes ~~~~~~~~~~~~~~ There are four tracing session modes: -Local mode:: +[[local-mode]]Local mode:: Traces the local system and writes the trace to the local file system. The option:--output option specifies the trace path. Using option:--set-url=file://'PATH' is the equivalent of using @@ -80,14 +80,14 @@ If none of the options mentioned above are used, then the trace is written locally in the `$LTTNG_HOME/lttng-traces` directory (`$LTTNG_HOME` defaults to `$HOME`). -Network streaming mode:: +[[network-streaming-mode]]Network streaming mode:: Traces the local system and sends the trace over the network to a listening relay daemon (see man:lttng-relayd(8)). The option:--set-url, or option:--ctrl-url and option:--data-url options set the trace output destination (see the <> section below). -Snapshot mode:: +[[snapshot-mode]]Snapshot mode:: Traces the local system without writing the trace to the local file system (implicit option:--no-output option). Channels are automatically configured to be snapshot-ready on creation (see @@ -96,7 +96,7 @@ Snapshot mode:: The option:--set-url, or option:--ctrl-url and option:--data-url options set the default snapshot output destination. -Live mode:: +[[live-mode]]Live mode:: Traces the local system, sending trace data to an LTTng relay daemon over the network (see man:lttng-relayd(8)). The option:--set-url, or option:--ctrl-url and option:--data-url options @@ -118,23 +118,36 @@ file://'TRACEPATH' 'NETPROTO'://('HOST' | 'IPADDR')[:__CTRLPORT__[:__DATAPORT__]][/'TRACEPATH'] The `file://` protocol targets the *local file system* and can only -be used as the option:--set-url option's argument in _local mode_. +be used as the option:--set-url option's argument when the session is +created in <> or <> mode. 'TRACEPATH':: Absolute path to trace files on the local file system. -The other version is used for the _network streaming mode_. +The other version is available when the session is created in +<>, +<>, or <> mode. 'NETPROTO':: Network protocol, amongst: + -* `net`: TCP over IPv4; the default values of `` and - `` are resp. 5342 and 5343 -* `net6`: TCP over IPv6: same default ports as `net` protocol -* `tcp`: same as `net` protocol; can only be used with the - option:--ctrl-url and option:--data-url options together -* `tcp6`: same as `net6` protocol; can only be used with the - option:--ctrl-url and option:--data-url options together +-- +`net`:: + TCP over IPv4; the default values of 'CTRLPORT' and 'DATAPORT' + are respectively {default_network_control_port} and + {default_network_data_port}. + +`net6`:: + TCP over IPv6: same default ports as the `net` protocol. + +`tcp`:: + Same as the `net` protocol; can only be used with the + option:--ctrl-url and option:--data-url options together. + +`tcp6`:: + Same as the `net6` protocol; can only be used with the + option:--ctrl-url and option:--data-url options together. +-- ('HOST' | 'IPADDR'):: Hostname or IP address (IPv6 address *must* be enclosed in brackets @@ -158,28 +171,31 @@ include::common-cmd-options-head.txt[] Mode selection ~~~~~~~~~~~~~~ option:--live[='DELAYUS']:: - Create the session in live mode. The optional 'DELAYUS' parameter, - given in microseconds, is the maximum time the user can wait for - the data to be flushed. This mode can be set with a network URL - (options option:--set-url, or option:--ctrl-url and option:--data-url) - and must have a relay daemon listening (see man:lttng-relayd(8)). + Create the session in <>. ++ +The optional 'DELAYUS' parameter, given in microseconds, is the +maximum time the user can wait for the data to be flushed. This mode +can be set with a network URL (options option:--set-url, or +option:--ctrl-url and option:--data-url) and must have a relay +daemon listening (see man:lttng-relayd(8)). + By default, 'DELAYUS' is {default_lttng_live_timer} and the network URL is set to `net://127.0.0.1`. option:--snapshot:: - Create the session in snapshot mode. This is the equivalent of using - the option:--no-output option and creating all the channels of this - new tracing session in overwrite mode with an `mmap` output type. + Create the session in <>. + This is the equivalent of using the option:--no-output option and + creating all the channels of this new tracing session in overwrite + mode with an `mmap` output type. Output ~~~~~~ option:--no-output:: - Do not output any trace data. + In <>, do not output any trace data. option:-o, option:--output='PATH':: - Set trace output path to 'PATH'. + In <>, set trace output path to 'PATH'. option:--shm-path='PATH':: Create shared memory holding buffers at 'PATH'. @@ -203,6 +219,9 @@ option:-U, option:--set-url='URL':: the session lifetime. This option sets both data (option:--data-url option) and control (option:--ctrl-url option) URLs at the same time. ++ +In <> mode, 'URL' must start with `file://` followed +by the destination path on the local file system. include::common-cmd-help-options.txt[]