# `Caracola.Transport.Handler`
[🔗](https://github.com/netkubes/caracola/blob/v0.1.0-rc.1/lib/caracola/transport/handler.ex#L1)

Receives the SIP messages arriving at a listener or connection.

Handlers are given as `{module, arg}` and called in the process owning the
socket, so they should hand the message over to another process quickly.
The `Caracola.Transport.Port` identifies where the message came from, and
can be used to reply with `Caracola.Transport.send/2`.

# `t`

```elixir
@type t() :: {module(), term()}
```

A handler: a module implementing this behaviour and the argument given to its callback.

# `handle_message`

```elixir
@callback handle_message(Caracola.Transport.Port.t(), Caracola.Message.t(), arg :: term()) ::
  any()
```

Called for each message received, in the process owning the socket. The
return value is ignored.

---

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