blob: 1ab93bad29f16769247bf425efb318d7d4c07bee [file] [view]
# net-cli
`net-cli` is a CLI tool which can run directly on target or as an FFX
plugin for configuring and inspecting the Netstack.
## `capture` subcommand
The `capture` subcommand is used for managing packet captures on Fuchsia.
### Start a rolling capture
Start capturing on interface `lo` using the default capture name `capture`:
```bash
net capture start-rolling name:lo
```
Start capturing on interface ID `2` with a custom name `my_capture`, packet size
limit of 100 bytes, and buffer size of 4 MiB:
```bash
net capture start-rolling --name my_capture --snap-len 100 --capture-size 4194304 id:2
```
Start capturing with a tcp port filter:
```bash
net capture start-rolling name:lo "tcp port 80"
```
### Stop and download/discard
Stop the default capture and download to the default `/tmp/pcap/capture.pcapng`:
```bash
net capture stop-rolling
```
Stop a custom capture and download to a specific path:
```bash
net capture stop-rolling --name my_capture --output /data/my_capture.pcapng
```
Stop capture and discard the data immediately without downloading:
```bash
net capture stop-rolling --skip-download
```