Skip to content

Commit 4cca24b

Browse files
authored
Merge pull request nicolaka#48 from John-Lin/termshark-docs
add termshark docs
2 parents 63eee66 + 4a845f3 commit 4cca24b

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

README.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,6 @@ Cool thing about namespaces is that you can switch between them. You can enter a
2222
`$ docker run -it --net container:<container_name> nicolaka/netshoot`
2323

2424
* **Host's Network Namespace:** If you think the networking issue is on the host itself, you can launch `netshoot` with that host's network namespace. This is how:
25-
2625
`$ docker run -it --net host nicolaka/netshoot`
2726

2827
* **Network's Network Namespace:** If you want to troubleshoot a Docker network, you can enter the network's namespace using `nsenter`. This is explained in the `nsenter` section below.
@@ -650,17 +649,24 @@ To get data into ctop, you'll need to bind docker.sock into the netshoot contain
650649

651650
It will display running and existed containers with useful metrics to help troubleshoot resource issues; hit "q" to exit.
652651

652+
## Termshark
653653

654-
## Feedback + Contribution
655-
656-
Feel free to provide feedback and contribute networking troubleshooting tools and use-cases by opening PRs.
657-
658-
654+
Termshark is a terminal user-interface for tshark. It allows user to read pcap files or sniff live interfaces with Wireshark's display filters.
659655

660656

657+
```
658+
# Launching netshoot with NET_ADMIN and CAP_NET_RAW capabilities. Capturing packets on eth0 with icmp
659+
/ # docker run --rm --cap-add=NET_ADMIN --cap-add=CAP_NET_RAW -it nicolaka/netshoot termshark -i eth0 icmp
660+
```
661661

662+
```
663+
# Launching netshoot with NET_ADMIN and CAP_NET_RAW capabilities Reading packets from ipv4frags.pcap
662664
665+
/ # docker run --rm --cap-add=NET_ADMIN --cap-add=CAP_NET_RAW -v /tmp/ipv4frags.pcap:/tmp/ipv4frags.pcap -it nicolaka/netshoot termshark -r /tmp/ipv4frags.pcap
666+
```
667+
More info on `termshark` [here](https://github.com/gcla/termshark)
663668

664-
665669

670+
## Feedback + Contribution
666671

672+
Feel free to provide feedback and contribute networking troubleshooting tools and use-cases by opening PRs.

0 commit comments

Comments
 (0)