2.4 KiB
title, homepage, tagline
| title | homepage | tagline |
|---|---|---|
| Trippy | https://github.com/fujiapple852/trippy | Trippy: A tool that combines the functionality of traceroute and ping designed for networking issue analysis. |
To update or switch versions, run webi trip@stable (or @v0.8, @beta, etc).
Cheat Sheet
Trippy combines the functionality of
tracerouteandpingto assist in analyzing networking issues. It supports multiple protocols such as ICMP, UDP, and TCP, and is equipped with a Tui interface for detailed analysis.
sudo env PATH="$PATH" trip example.com
Table of Contents
- Files
- Granting Root
- Tracing Protocols
- Tracing Options
- GoeIP Map
Files
These are the files / directories that are created and/or modified with this install:
~/.config/trippy.toml
~/.local/bin/trip
<PROJECT-DIR>/.trippy.toml
# Windows
~/.local/bin/sudo.cmd
/Windows/System32/vcruntime140.dll (msvc runtime)
How to Always Run as Root
Due to the nature of raw network access, trip always needs to run with
elevated network privileges.
On Linux setcap can be used to limit its root privileges to the network only.
On other systems it may need full root access.
Linux
trip_bin="$( readlink -f "$( command -v trip )" )"
sudo setcap 'CAP_NET_RAW+p' "${trip_bin}"
macOS
trip_bin="$( command -v trip )"
sudo chown root "${trip_bin}" && \
sudo chmod +s "${trip_bin}"
Windows
- You need to add a firewall rule to allow ICMP
New-NetFirewallRule -DisplayName "ICMP Trippy Allow" -Name ICMP_TRIPPY_ALLOW -Protocol ICMPv4 -Action Allow - You'll need to run with an Administrator shell, or
sudo.cmdevery time:sudo.cmd trip.exe example.com
How to Trace with Various Protocols
You can use icmp, tcp, or udp:
trip --protocol icmp example.com
How to set Tracing Options
You can pick a payload byte pattern (0-255) and packet size:
trip --packet-size 64 --payload-pattern 255
How to View GeoIP Mapping
You'll need to download a geoip map database, such as this:
trip example.com --geoip-mmdb-file ./GeoLite2-City.mmdb --tui-geoip-mode long
