ksp diag
ksp diag
Command ReferencePerform deep-packet diagnostic testing, latency jitter profiling, and MTU discovery on KSP endpoints.
Networking & Diagnostics
Purpose
Perform deep-packet diagnostic testing, latency jitter profiling, and MTU discovery on KSP endpoints.
Syntax
Command-line specificationbash / powershell
ksp diag <TARGET_URI> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <TARGET_URI> | Target KSP endpoint address (e.g., `127.0.0.1:9876` or `ksp://api.kspprotocol.dev:9876`). |
Options & Flags
| Option Flag | Description |
|---|---|
| --mtu-probe | Perform Path MTU Discovery (PMTUD) to determine exact unfragmented frame limits. |
| --jitter-test <SECONDS> | Run high-precision packet jitter analysis for the specified duration. |
| --json | Emit diagnostic metrics as JSON objects for automated CI pipelines. |
Example Usage
Example command
ksp diag 127.0.0.1:9876 --mtu-probe
Expected Output
[+] Probing Path MTU to 127.0.0.1:9876... [+] Sending ICMP/UDP framing probes starting at 1500 bytes... [✔] Maximum Transmission Unit (MTU): 1472 bytes payload (1500 frame) [✔] Round Trip Jitter: Avg 0.42 ms | Min 0.31 ms | Max 0.89 ms | StdDev 0.08 ms [✔] Packet Loss Rate: 0.00% across 500 test frames Diagnostic status: Optimal channel health.
Implementation Notes
Helps fine-tune stream window sizes and buffer thresholds across high-latency WAN or cellular connections.