trip(1)

📦
version 0.13.0 · 6 versions
, in arch rolling

🦋 NAME 🦋

Okay so bestie, welcome to trip(1) from the General Commands Manual — she's trip, and she's A network diagnostic tool. That's the whole NAME vibe: trip — A network diagnostic tool. 💅

✨ SYNOPSIS ✨

       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]

🎀 DESCRIPTION 🎀

A network diagnostic tool. That's literally the DESCRIPTION, and honestly the confidence of it. No extra lore in the section — just pure network-diagnostic main character energy. 💖

💅 OPTIONS 💅

Okay bestie, here's the full option buffet. Every flag, every value, every default — no skips, no cap. 🌸

  • -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 — iconic version behavior. 👑

👑 AUTHORS 👑

FujiApple <fujiapple852@gmail.com> — the author, and we love that for them. 🫶

✨ cute sign-off: the footer vibe is trip 0.13.0, so that's the source/version energy, bestie. 💖🎀

📦 where this page comes from