.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "UFTRACE-RECV" "1" "Sep, 2018" "Uftrace User Manuals" ""
.hy
.SH NAME
.PP
uftrace-recv - Receive tracing data from socket and save it to files
.SH SYNOPSIS
.PP
uftrace recv [\f[I]options\f[R]]
.SH DESCRIPTION
.PP
This command receives tracing data from the network and saves it to
files.
Data will be sent using \f[V]uftrace-record\f[R] with --host option.
.SH OPTIONS
.TP
-d \f[I]DATA\f[R], --data=\f[I]DATA\f[R]
Specify directory name to save received data.
.TP
--port=\f[I]PORT\f[R]
Use given port instead of the default (8090).
.TP
--run-cmd=\f[I]COMMAND\f[R]
Run given (shell) command as soon as receive data.
For example, one can run \f[V]uftrace replay\f[R] for received data.
.SH EXAMPLE
.PP
The uftrace recv command should be run before sending data by record
command.
.IP
.nf
\f[C]
# HOST
$ uftrace recv -d recv_data --port 1234
\f[R]
.fi
.PP
Above command starts a server with port by given (default
\f[V]8090\f[R]) to receive data from remote client.
.IP
.nf
\f[C]
# CLIENT
$ uftrace record -d example_data --host localhost --port 1234 example
\f[R]
.fi
.PP
Above command sends the trace data to a remote server that pointed by
given \f[V]--host\f[R] option (\f[V]localhost\f[R] in this case) after
running the example program.
And as you see, you can choose save directory by using \f[V]-d\f[R]
option (sending data will save to \f[V]example_data\f[R] in this case).
.IP
.nf
\f[C]
# HOST : Check received data
$ uftrace replay -d recv_data/example_data
# DURATION    TID     FUNCTION
            [17308] | main() {
            [17308] |   a() {
            [17308] |     b() {
            [17308] |       c() {
   1.058 us [17308] |         getpid();
   4.356 us [17308] |       } /* c */
   4.664 us [17308] |     } /* b */
   4.845 us [17308] |   } /* a */
   5.076 us [17308] | } /* main */
\f[R]
.fi
.PP
You can find saved trace data of example from \f[V]recv_data\f[R]\[cq]s
subdirectory \f[V]example_data\f[R].
Obviously, you should check at \f[V]HOST\f[R].
.SH SEE ALSO
.PP
\f[V]uftrace\f[R](1), \f[V]uftrace-record\f[R](1)
.SH AUTHORS
Namhyung Kim <namhyung@gmail.com>.