KSP — Kush Secure Protocol

Networking & Diagnostics

Purpose

Perform deep-packet diagnostic testing, latency jitter profiling, and MTU discovery on KSP endpoints.

Syntax

Command-line specification

bash / 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.

Related CommandsView All 50 Commands →

ksp ping

ksp trace

ksp doctor

CLI Installation Guide· Quick Start Workflow· GitHub Source Repository