trip1

A network diagnostic tool

Usage

trip [{-c | --config-file}] [{-m | --mode}] [{-u | --unprivileged}] [{-p | --protocol}] [--udp] [--tcp] [--icmp] [{-F | --addr-family}] [{-4 | --ipv4}] [{-6 | --ipv6}] [{-P | --target-port}] [{-S | --source-port}] [{-A | --source-address}] [{-I | --interface}] [{-i | --min-round-duration}] [{-T | --max-round-duration}] [{-g | --grace-duration}] [--initial-sequence] [{-R | --multipath-strategy}] [{-U | --max-inflight}] [{-f | --first-ttl}] [{-t | --max-ttl}] [--packet-size] [--payload-pattern] [{-Q | --tos}] [{-e | --icmp-extensions}] [--read-timeout] [{-r | --dns-resolve-method}] [{-y | --dns-resolve-all}] [--dns-timeout] [--dns-ttl] [{-z | --dns-lookup-as-info}] [{-s | --max-samples}] [--max-flows] [{-a | --tui-address-mode}] [--tui-as-mode] [--tui-custom-columns] [--tui-icmp-extension-mode] [--tui-geoip-mode] [{-M | --tui-max-addrs}] [--tui-preserve-screen] [--tui-refresh-rate] [--tui-privacy-max-ttl] [--tui-locale] [--tui-timezone] [--tui-theme-colors] [--print-tui-theme-items] [--tui-key-bindings] [--print-tui-binding-commands] [{-C | --report-cycles}] [{-G | --geoip-mmdb-file}] [--generate] [--generate-man] [--print-config-template] [--print-locales] [--log-format] [--log-filter] [--log-span-events] [{-v | --verbose}] [{-h | --help}] [{-V | --version}] [TARGETS]

Overview

A network diagnostic tool

Options

-c, --config-file=CONFIG_FILE: Config file

-m, --mode=MODE

Output mode [default: tui]

Possible values:

•: tui: Display interactive TUI

•: stream: Display a continuous stream of tracing data

•: pretty: Generate a pretty text table report for N cycles

•: markdown: Generate a Markdown text table report for N cycles

•: csv: Generate a CSV report for N cycles

•: json: Generate a JSON report for N cycles

•: dot: Generate a Graphviz DOT file for N cycles

•: flows: Display all flows for N cycles

•: silent: Do not generate any tracing output for N cycles

-u, --unprivileged: Trace without requiring elevated privileges on supported platforms [default: false]

-p, --protocol=PROTOCOL

Tracing protocol [default: icmp]

Possible values:

•: icmp: Internet Control Message Protocol

•: udp: User Datagram Protocol

•: tcp: Transmission Control Protocol

--udp: Trace using the UDP protocol

--tcp: Trace using the TCP protocol

--icmp: Trace using the ICMP protocol

-F, --addr-family=ADDR_FAMILY

The address family [default: ipv4-then-ipv6]

Possible values:

•: ipv4: IPv4 only

•: ipv6: IPv6 only

•: ipv6-then-ipv4: IPv6 with a fallback to IPv4

•: ipv4-then-ipv6: IPv4 with a fallback to IPv6

•: system: If the OS resolver is being used then use the first IP address returned, otherwise lookup IPv6 with a fallback to IPv4

-4, --ipv4: Use IPv4 only

-6, --ipv6: Use IPv6 only

-P, --target-port=TARGET_PORT: The target port (TCP & UDP only) [default: 80]

-S, --source-port=SOURCE_PORT: The source port (TCP & UDP only) [default: auto]

-A, --source-address=SOURCE_ADDRESS: The source IP address [default: auto]

-I, --interface=INTERFACE: The network interface [default: auto]

-i, --min-round-duration=MIN_ROUND_DURATION: The minimum duration of every round [default: 1s]

-T, --max-round-duration=MAX_ROUND_DURATION: The maximum duration of every round [default: 1s]

-g, --grace-duration=GRACE_DURATION: The period of time to wait for additional ICMP responses after the target has responded [default: 100ms]

--initial-sequence=INITIAL_SEQUENCE: The initial sequence number [default: 33434]

-R, --multipath-strategy=MULTIPATH_STRATEGY

The Equal-cost Multi-Path routing strategy (UDP only) [default: classic]

Possible values:

•: classic: The src or dest port is used to store the sequence number

•: paris: The UDP `checksum` field is used to store the sequence number

•: dublin: The IP `identifier` field is used to store the sequence number

-U, --max-inflight=MAX_INFLIGHT: The maximum number of in-flight ICMP echo requests [default: 24]

-f, --first-ttl=FIRST_TTL: The TTL to start from [default: 1]

-t, --max-ttl=MAX_TTL: The maximum number of TTL hops [default: 64]

--packet-size=PACKET_SIZE: The size of IP packet to send (IP header + ICMP header + payload) [default: 84]

--payload-pattern=PAYLOAD_PATTERN: The repeating pattern in the payload of the ICMP packet [default: 0]

-Q, --tos=TOS: The TOS (i.e. DSCP+ECN) IP header value (IPv4 only) [default: 0]

-e, --icmp-extensions: Parse ICMP extensions

--read-timeout=READ_TIMEOUT: The socket read timeout [default: 10ms]

-r, --dns-resolve-method=DNS_RESOLVE_METHOD

How to perform DNS queries [default: system]

Possible values:

•: system: Resolve using the OS resolver

•: resolv: Resolve using the `/etc/resolv.conf` DNS configuration

•: google: Resolve using the Google `8.8.8.8` DNS service

•: cloudflare: Resolve using the Cloudflare `1.1.1.1` DNS service

-y, --dns-resolve-all: Trace to all IPs resolved from DNS lookup [default: false]

--dns-timeout=DNS_TIMEOUT: The maximum time to wait to perform DNS queries [default: 5s]

--dns-ttl=DNS_TTL: The time-to-live (TTL) of DNS entries [default: 300s]

-z, --dns-lookup-as-info: Lookup autonomous system (AS) information during DNS queries [default: false]

-s, --max-samples=MAX_SAMPLES: The maximum number of samples to record per hop [default: 256]

--max-flows=MAX_FLOWS: The maximum number of flows to record [default: 64]

-a, --tui-address-mode=TUI_ADDRESS_MODE

How to render addresses [default: host]

Possible values:

•: ip: Show IP address only

•: host: Show reverse-lookup DNS hostname only

•: both: Show both IP address and reverse-lookup DNS hostname

--tui-as-mode=TUI_AS_MODE

How to render autonomous system (AS) information [default: asn]

Possible values:

•: asn: Show the ASN

•: prefix: Display the AS prefix

•: country-code: Display the country code

•: registry: Display the registry name

•: allocated: Display the allocated date

•: name: Display the AS name

--tui-custom-columns=TUI_CUSTOM_COLUMNS: Custom columns to be displayed in the TUI hops table [default: holsravbwdt]

--tui-icmp-extension-mode=TUI_ICMP_EXTENSION_MODE

How to render ICMP extensions [default: off]

Possible values:

•: off: Do not show `icmp` extensions

•: mpls: Show MPLS label(s) only

•: full: Show full `icmp` extension data for all known extensions

•: all: Show full `icmp` extension data for all classes

--tui-geoip-mode=TUI_GEOIP_MODE

How to render GeoIp information [default: short]

Possible values:

•: off: Do not display GeoIp data

•: short: Show short format

•: long: Show long format

•: location: Show latitude and Longitude format

-M, --tui-max-addrs=TUI_MAX_ADDRS: The maximum number of addresses to show per hop [default: auto]

--tui-preserve-screen: Preserve the screen on exit [default: false]

--tui-refresh-rate=TUI_REFRESH_RATE: The TUI refresh rate [default: 100ms]

--tui-privacy-max-ttl=TUI_PRIVACY_MAX_TTL

The maximum ttl of hops which will be masked for privacy [default: none]

If set, the source IP address and hostname will also be hidden.

--tui-locale=TUI_LOCALE: The locale to use for the TUI [default: auto]

--tui-timezone=TUI_TIMEZONE

The timezone to use for the TUI [default: auto]

The timezone must be a valid IANA timezone identifier.

--tui-theme-colors=TUI_THEME_COLORS: The TUI theme colors [item=color,item=color,..]

--print-tui-theme-items: Print all TUI theme items and exit

--tui-key-bindings=TUI_KEY_BINDINGS: The TUI key bindings [command=key,command=key,..]

--print-tui-binding-commands: Print all TUI commands that can be bound and exit

-C, --report-cycles=REPORT_CYCLES: The number of report cycles to run [default: 10]

-G, --geoip-mmdb-file=GEOIP_MMDB_FILE: The supported MaxMind or IPinfo GeoIp mmdb file

--generate=GENERATE

Generate shell completion

[possible values: bash, elvish, fish, powershell, zsh]

--generate-man: Generate ROFF man page

--print-config-template: Print a template toml config file and exit

--print-locales: Print all available TUI locales and exit

--log-format=LOG_FORMAT

The debug log format [default: pretty]

Possible values:

•: compact: Display log data in a compact format

•: pretty: Display log data in a pretty format

•: json: Display log data in a json format

•: chrome: Display log data in Chrome trace format

--log-filter=LOG_FILTER: The debug log filter [default: trippy=debug]

--log-span-events=LOG_SPAN_EVENTS

The debug log format [default: off]

Possible values:

•: off: Do not display event spans

•: active: Display enter and exit event spans

•: full: Display all event spans

-v, --verbose: Enable verbose debug logging

-h, --help: Print help (see a summary with '-h')

-V, --version: Print version

[TARGETS]: A space delimited list of hostnames and IPs to trace

Version

v0.13.0

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

13
Arch

--tui-timezone since Arch Linux 2026-11-01.