Scroll to navigation

trip(1) General Commands Manual trip(1)

NAME

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

OPTIONS

Config file
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
Trace without requiring elevated privileges on supported platforms [default: false]
Tracing protocol [default: icmp]

Possible values:

  • icmp: Internet Control Message Protocol
  • udp: User Datagram Protocol
  • tcp: Transmission Control Protocol
Trace using the UDP protocol
Trace using the TCP protocol
Trace using the ICMP protocol
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
The target port (TCP & UDP only) [default: 80]
The source port (TCP & UDP only) [default: auto]
The source IP address [default: auto]
The network interface [default: auto]
The minimum duration of every round [default: 1s]
The maximum duration of every round [default: 1s]
The period of time to wait for additional ICMP responses after the target has responded [default: 100ms]
The initial sequence number [default: 33434]
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
The maximum number of in-flight ICMP echo requests [default: 24]
The TTL to start from [default: 1]
The maximum number of TTL hops [default: 64]
The size of IP packet to send (IP header + ICMP header + payload) [default: 84]
The repeating pattern in the payload of the ICMP packet [default: 0]
The TOS (i.e. DSCP+ECN) IP header value (IPv4 only) [default: 0]
Parse ICMP extensions
The socket read timeout [default: 10ms]
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
Trace to all IPs resolved from DNS lookup [default: false]
The maximum time to wait to perform DNS queries [default: 5s]
The time-to-live (TTL) of DNS entries [default: 300s]
Lookup autonomous system (AS) information during DNS queries [default: false]
The maximum number of samples to record per hop [default: 256]
The maximum number of flows to record [default: 64]
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
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
Custom columns to be displayed in the TUI hops table [default: holsravbwdt]
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
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
The maximum number of addresses to show per hop [default: auto]
Preserve the screen on exit [default: false]
The TUI refresh rate [default: 100ms]
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.

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

The timezone must be a valid IANA timezone identifier.

The TUI theme colors [item=color,item=color,..]
Print all TUI theme items and exit
The TUI key bindings [command=key,command=key,..]
Print all TUI commands that can be bound and exit
The number of report cycles to run [default: 10]
The supported MaxMind or IPinfo GeoIp mmdb file
Generate shell completion

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

Generate ROFF man page
Print a template toml config file and exit
Print all available TUI locales and exit
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
The debug log filter [default: trippy=debug]
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
Enable verbose debug logging
Print help (see a summary with '-h')
Print version
[TARGETS]
A space delimited list of hostnames and IPs to trace

VERSION

v0.13.0

AUTHORS

FujiApple <fujiapple852@gmail.com>

trip 0.13.0