Man page - trip(1)

Packages contains this manual

Package: trippy
apt-get install trippy

Manuals in package:

trip(1)

Documentations in package:

trippy

Manual

trip

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
VERSION
AUTHORS

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-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

-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 (TCP and UDP 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-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.12.2

AUTHORS

FujiApple <fujiapple852@gmail.com>