Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TRIP(1)				 User Commands			       TRIP(1)

NAME
       trip - Network diagnostic tool inspired by mtr

SYNOPSIS
       trip [OPTIONS] [TARGETS]...

DESCRIPTION
       A network diagnostic tool

   Arguments:
	      [TARGETS]...

	      A	space delimited	list of	hostnames and IPs to trace

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 gen-
	      erate any	tracing	output for N cycles

       -u, --unprivileged

	      Trace  without  requiring	elevated privileges on supported plat-
	      forms [default: false]

       -p, --protocol <PROTOCOL>

	      Tracing protocol [default: icmp]

	      Possible values: - icmp: Internet	 Control  Message  Protocol  -
	      udp:  User Datagram Protocol - tcp:  Transmission	Control	Proto-
	      col

       --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  +  pay-
	      load) [default: 84]

       --payload-pattern <PAYLOAD_PATTERN>

	      The  repeating  pattern  in  the payload of the ICMP packet [de-
	      fault: 0]

       -Q, --tos <TOS>

	      The TOS (i.e. DSCP+ECN) IP header	value (TCP and UDP only)  [de-
	      fault: 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  configura-
	      tion  -  google:	   Resolve using the Google `8.8.8.8` DNS ser-
	      vice - 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  re-
	      verse-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 [de-
	      fault: 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:	  Dis-
	      play 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

trip 0.12.2			  April	2025			       TRIP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=trip&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help