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

-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

AUTHORS
FujiApple <fujiapple852@gmail.com>