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)

AUTHORS

       Namhyung Kim <namhyung@gmail.com>.