CLI reference / resolver / relay

stado resolver relay

Invocation

stado resolver relay [OPTIONS] --consumer <CONSUMER> --bind <BIND> <SERVICE>

Purpose

One caller's own route to a service placed on another host, carried over this process's SSH session to that host while the caller holds this process (its standard input open). Prints the loopback URL to dial first, as one line (`--json`: one document). For a service placed on this host the service's own loopback URL is printed and the process ends. The route the host resolver's adapter would give, when that resolver holds no listener for it

Required inputs and options

Input or optionContract
<SERVICE>Logical service name, with or without the stado://service/ prefix
--consumer <CONSUMER>Stable workload identity the directory grants the service to
--bind <BIND>The loopback host:port to listen on: one this host hands out now (`stado host local port`)
--jsonEmit machine-readable output

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.