Skip to content

rhp CLI

rhp is a single binary with five sub-commands. All of them share a common option vocabulary so you can swap between, say, rhp probe and rhp chat without re-learning the flags.

rhp <command> [options]

COMMANDS
  chat     Open an interactive AX.25 / NetRom STREAM session.
  mon      Monitor a radio port in TRACE mode (decoded headers + payload).
  send     Transmit a one-shot UI/datagram frame and exit.
  probe    Connect to an RHP node, run AUTH (if requested), report status.
  serve    Run a local mock RHPv2 server (developer harness).

Common options

Flag Meaning Default
--host <host> RHP host 127.0.0.1
--port <port> TCP port 9000
--user <user> AUTH username (sent if non-empty) (none)
--pass <pass> AUTH password (empty)
--pfam <family> ax25 / netrom / inet / unix ax25
--mode <mode> stream / dgram / trace / raw per command
--radio <port> XRouter radio port id (e.g. "1") (required)
--local <call> Local callsign / address (per cmd)
--remote <call> Remote callsign / address (per cmd)
-h, --help Print command-specific help.

Exit codes

Code Meaning
0 Success.
1 Generic failure (message on stderr).
64 Usage error (missing required flag).
130 SIGINT / Ctrl-C.

Sub-command pages

  • probe — connectivity smoke test.
  • chat — interactive STREAM session.
  • mon — TRACE-mode frame monitor.
  • send — one-shot UI / datagram transmitter.
  • serve — local mock RHPv2 server.