ksp trace
ksp trace
Command ReferenceTrace every individual hop, nonce transition, and stream frame for a specific connection across your network.
Networking & Diagnostics
Purpose
Trace every individual hop, nonce transition, and stream frame for a specific connection across your network.
Syntax
Command-line specificationbash / powershell
ksp trace <SESSION_ID_OR_URI> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <SESSION_ID_OR_URI> | Session ID (e.g., `0x4B9E3A`) or target server URI. |
Options & Flags
| Option Flag | Description |
|---|---|
| --deep | Log full cryptographic AEAD authentication tag verification steps for every packet. |
Example Usage
Example command
ksp trace 0x4B9E3A --deep
Expected Output
Tracing Session 0x4B9E3A... [00.00ms] Hop 1: Local socket 127.0.0.1:54112 → Router (0.1ms) [00.12ms] Hop 2: Ingress Gateway 127.0.0.1:9876 (Stream #1 header checked) [00.18ms] Crypto: Nonce 0x00000001 || Salt verified against sliding window [✔] Frame #104 successfully processed without jitter or drop.
Implementation Notes
Pinpoints exactly where packet loss, reordering, or firewall drops occur across complex networks.