webinstall.dev/trip Star on GitHub

To update or switch versions, run webi trip@stable (or @v0.8, @beta, etc).

Cheat Sheet

Trippy combines the functionality of traceroute and ping to 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

1. You need to add a firewall rule to allow ICMP

   New-NetFirewallRule -DisplayName "ICMP Trippy Allow" -Name ICMP_TRIPPY_ALLOW -Protocol ICMPv4 -Action Allow
   

2. You'll need to run with an Administrator shell, or sudo.cmd every 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:

• https://dev.maxmind.com/geoip/geolite2-free-geolocation-data

trip example.com --geoip-mmdb-file ./GeoLite2-City.mmdb --tui-geoip-mode long