---
name: "uftrace-recv"
section: "1"
platform: "linux"
package: "uftrace"
version: "0.17-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/uftrace-recv"
---

# uftrace-recv(1)

Receive tracing data from socket and save it to files

## 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/1.md), [`uftrace-record`(1)](/uftrace-record/1.md)

## AUTHORS

Namhyung Kim ⟨namhyung@gmail.com⟩\\c.