Copyright	(c) 2018-2019 Commonwealth Scientific and Industrial Research Organisation
License	BSD3
Maintainer	dave.laing.80@gmail.com, jack.kelly@data61.csiro.au
Stability	experimental
Portability	non-portable
Safe Haskell	None
Language	Haskell2010

Reflex.Backend.Socket.Accept

Contents

Description

Use accept to create listen sockets, and get an Event t Socket of new connections.

Synopsis

Documentation

Arguments

:: (Reflex t, PerformEvent t m, PostBuild t m, TriggerEvent t m, MonadIO (Performable m), MonadIO m)
=> AcceptConfig t
-> m (Event t (Either SetupError (Accept t)))	This event will fire exactly once.

Create a listening socket. Sockets are accepted in a background thread.

Listen socket configuration

Configuration of a listen socket.

Constructors

Fields

_acHostname :: Maybe HostName
The hostname to bind to. This will often be Nothing, to bind all interfaces.
_acService :: Maybe ServiceName
The port number or service name to listen on. See the manpage for getaddrinfo.
_acListenQueue :: Int
The length of the "pending connections" queue. See the manpage for listen.
_acSocketOptions :: [(SocketOption, Int)]
List of socket options, passed one at a time to setSocketOption. Many people will want [(ReuseAddr, 1)] here.
_acClose :: Event t ()
Close the listen socket when this event fires. If you plan to run forever, use never.

Events produced by a running listen socket.

Constructors

Fields

_aAcceptSocket :: Event t (Socket, SockAddr)
A new connection was accepted, including its remote address.
_aClose :: Event t ()
The socket has closed. This will fire exactly once when the socket closes for any reason, including if your _acClose event fires or if the socket closes in response to a caught exception.
_aError :: Event t IOException
An exception occurred. Treat the socket as closed after you see this. You will see the _aClose event fire as well, but not necessarily in the same frame.