# `Hyper.Node.FireVMM.Agent.RelayDialer`
[🔗](https://github.com/harmont-dev/hyper/blob/main/lib/hyper/node/fire_vmm/agent/relay_dialer.ex#L1)

Connects to a Firecracker vsock Unix-domain socket and performs the
host-initiated CONNECT/OK handshake, returning the open socket ready for
use as a transparent byte pipe to the guest agent.

Firecracker exposes its guest vsock as a host UDS. Before the connection
becomes a transparent pipe, the host must send `"CONNECT <port>\n"` and
receive a line starting with `"OK "`. This module implements that handshake.

# `dial`

```elixir
@spec dial(Path.t(), pos_integer(), non_neg_integer()) ::
  {:ok, :socket.socket()} | {:error, term()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*