gun_up(3)

Name

gun_up - The connection is up

Description

{gun_up, ConnPid, Protocol}

ConnPid  :: pid()
Protocol :: http | http2

The connection is up.

This message informs the owner process that the connection or reconnection completed.

Gun will now start processing the messages it received while waiting for the connection to be up. If this is a reconnection, then this may not be desirable for all requests. Those requests should be cancelled when the connection goes down, and any subsequent messages ignored.

Elements

ConnPid

The pid of the Gun connection process.

Protocol

The protocol selected for this connection. It can be used to determine the capabilities of the server.

Changelog

  • 1.0: Message introduced.

Examples

Receive a gun_up message in a gen_server
handle_info({gun_up, ConnPid, _Protocol},
            State=#state{conn_pid=ConnPid}) ->
    %% Do something.
    {noreply, State}.

See also

gun(3), gun:open(3), gun:open_unix(3), gun:await_up(3), gun_down(3), gun_error(3)

Gun 1.1 Function Reference

Navigation

Version select

Like my work? Donate!

Donate to Loïc Hoguin because his work on Cowboy, Ranch, Gun and Erlang.mk is fantastic:

Recurring payment options are also available via GitHub Sponsors. These funds are used to cover the recurring expenses like food, dedicated servers or domain names.