1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
|
% UFTRACE-RECV(1) Uftrace User Manuals
% Namhyung Kim <namhyung@gmail.com>
% Sep, 2018
NAME
====
uftrace-recv - Receive tracing data from socket and save it to files
SYNOPSIS
========
uftrace recv [*options*]
DESCRIPTION
===========
This command receives tracing data from the network and saves it to files.
Data will be sent using `uftrace-record` with \--host option.
OPTIONS
=======
-d *DATA*, \--data=*DATA*
: Specify directory name to save received data.
\--port=*PORT*
: Use given port instead of the default (8090).
\--run-cmd=*COMMAND*
: Run given (shell) command as soon as receive data. For example, one can
run `uftrace replay` for received data.
EXAMPLE
=======
The uftrace recv command should be run before sending data by record command.
# HOST
$ uftrace recv -d recv_data --port 1234
Above command starts a server with port by given (default `8090`) to receive
data from remote client.
# CLIENT
$ uftrace record -d example_data --host localhost --port 1234 example
Above command sends the trace data to a remote server that pointed by given
`--host` option (`localhost` in this case) after running the example program.
And as you see, you can choose save directory by using `-d` option (sending data
will save to `example_data` in this case).
# 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 */
You can find saved trace data of example from `recv_data`'s subdirectory
`example_data`. Obviously, you should check at `HOST`.
SEE ALSO
========
`uftrace`(1), `uftrace-record`(1)
|