Skip to main content

netft check

Runs a bounded stream and reports measured rate, sequence continuity, status, and recovery. Criteria are opt-in; a violated configured criterion exits with code 7.

Synopsis

netft check [HOST] [OPTIONS]

Run a bounded sensor stream health check.

Options

OptionValueDescription
-v, --verboseflagShow additional diagnostic progress.
-q, --quietflagSuppress progress output.
--colorauto|always|neverControl color in human-readable output.
--http-portPORTSet the sensor HTTP port.
--rdt-portPORTSet the sensor RDT port.
--timeoutDURATIONSet the connection timeout.
--formatauto|text|json|table|ndjson|csvSelect the output format.
--outputPATHWrite output to a file.
--durationDURATIONStop after a bounded duration.
--min-rateNUMBERRequire a minimum observed receive rate.
--max-lossNUMBERAllow at most this packet loss percentage.
--max-reconnectsINTEGERAllow at most this many reconnects.

Exit status

CodeMeaning
0Completed successfully
2Invalid command line or configuration
3Sensor discovery failed
4Stream connection or acquisition failed
5Sensor reported a fault
6Input/output operation failed
7A check acceptance criterion failed
130Interrupted

Examples

netft check sensor.example
netft check sensor.example --format json