OS Manuals

/usr/bin/test-connection

From calico-felix-fips-3.32 3.32.3-r2 (enterprise-packages), captured 2026-11-09 by running test-connection --help (exit 0). permalink

time="2026-11-09T14:32:49Z" level=info msg="Loaded config" func=github.com/projectcalico/calico/felix/fv/utils.init.0 file="/home/build/felix/fv/utils/utils.go:66" config="{calico/felix-test:latest quay.io/coreos/etcd calico/go-build:latest calico/typha:latest busybox:latest}"
test-connection: test connection to some target, for Felix FV testing.

Usage:
  test-connection <namespace-path> <ip-address> <port> [--source-ip=<source_ip>] [--source-port=<source>] [--protocol=<protocol>] [--duration=<seconds>] [--loop-with-file=<file>] [--sendlen=<bytes>] [--recvlen=<bytes>] [--log-pongs] [--stdin] [--timeout=<seconds>] [--sleep=<seconds>]

Options:
  --source-ip=<source_ip>  Source IP to use for the connection [default: 0.0.0.0].
  --source-port=<source>   Source port to use for the connection [default: 0].
  --protocol=<protocol>    Protocol to test tcp (default), udp (connected) udp-noconn (unconnected).
  --duration=<seconds>     Total seconds test should run. 0 means run a one off connectivity check. Non-Zero means packets loss test.[default: 0]
  --loop-with-file=<file>  Whether to send messages repeatedly, file is used for synchronization
  --log-pongs              Whether to log every response
  --debug                  Enable debug logging
  --sendlen=<bytes>        How many additional bytes to send
  --recvlen=<bytes>        Tell the other side to send this many additional bytes
  --stdin                  Read and send data from stdin
  --timeout=<seconds>      Exit after timeout if pong not received
  --sleep=<seconds>        How long to sleep before seding another ping

If connection is successful, test-connection exits successfully.

If connection is unsuccessful, test-connection panics and so exits with a failure status.
Options (12)
OptionDescriptionSource
--source-ip source_ipSource IP to use for the connection [default: 0.0.0.0].help
--source-port sourceSource port to use for the connection [default: 0].help
--protocol protocolProtocol to test tcp (default), udp (connected) udp-noconn (unconnected).help
--duration secondsTotal seconds test should run.help
--loop-with-file fileWhether to send messages repeatedly, file is used for synchronizationhelp
--log-pongsWhether to log every responsehelp
--debugEnable debug logginghelp
--sendlen bytesHow many additional bytes to sendhelp
--recvlen bytesTell the other side to send this many additional byteshelp
--stdinRead and send data from stdinhelp
--timeout secondsExit after timeout if pong not receivedhelp
--sleep secondsHow long to sleep before seding another pinghelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.