ksp transfer
ksp transfer
Command ReferenceSend a file or directory securely to a remote peer or `ksp receive` instance over chunked KSP streams.
Networking & Diagnostics
Purpose
Send a file or directory securely to a remote peer or `ksp receive` instance over chunked KSP streams.
Syntax
Command-line specificationbash / powershell
ksp transfer <FILE_PATH> --to <REMOTE_URI> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <FILE_PATH> | Path to local file or folder to transmit. |
Options & Flags
| Option Flag | Description |
|---|---|
| --to <URI> | Target receiver KSP address (e.g., `127.0.0.1:9876`). |
| --chunk-size <BYTES> | Stream chunk split threshold (default: `65536`). |
| --compress | Enable on-the-fly LZ4 stream compression before AEAD encryption. |
Example Usage
Example command
ksp transfer ./ubuntu.iso --to 127.0.0.1:9876 --compress
Expected Output
[+] File: ubuntu.iso (4.2 GB) [+] Destination: 127.0.0.1:9876 [+] Compression: LZ4 Active [+] Handshake: Verified (Ed25519) Transferring via Stream ID #3... [██████████████████████████████████████--] 94% (485 MB/s | ETA: 0s) ✔ File successfully delivered and SHA-256 integrity verified!
Implementation Notes
Automatically negotiates parallel stream chunks to maximize pipe utilization over high-bandwidth links.