Network.Run.TCP

Simple functions to run TCP clients and servers.

Server

runTCPServer :: Maybe HostName -> ServiceName -> (Socket -> IO a) -> IO a

Running a TCP server with an accepted socket and its peer name.

This is the same as:

runTCPServerWithSocketOptions []

runTCPServerWithSocket

Arguments

:: Socket

-> (Socket -> IO a)

Called for each incoming connection, in a new thread

-> IO a

Running a TCP client with a connected socket for a given listen socket.

openTCPServerSocket :: AddrInfo -> IO Socket

Open TCP socket for server use

This is the same as:

openTCPServerSocketWithOptions []

openTCPServerSocketWithOptions :: [(SocketOption, Int)] -> AddrInfo -> IO Socket

Open socket for server use, and set the provided options before binding.

In addition to the given options, the socket is configured to

• allow reuse of local addresses (SO_REUSEADDR)
• automatically be closed during a successful execve (FD_CLOEXEC)
• bind to the address specified
• listen with queue length with 1024

resolve :: SocketType -> Maybe HostName -> ServiceName -> [AddrInfoFlag] -> IO AddrInfo

Client

runTCPClient :: HostName -> ServiceName -> (Socket -> IO a) -> IO a

Running a TCP client with a connected socket.

This is the same as:

runTCPClientWithSettings defaultSettings

data Settings

Settings for client.

defaultSettings :: Settings

Default settings.

settingsOpenClientSocket :: Settings -> AddrInfo -> IO Socket

Opening a socket. Use openClientSocketWithOptions to specify SocketOption

runTCPClientWithSettings :: Settings -> HostName -> ServiceName -> (Socket -> IO a) -> IO a

Running a TCP client with a connected socket.

openClientSocket :: AddrInfo -> IO Socket

This is the same as

openClientSocketWithOptions []

openClientSocketWithOptions :: [(SocketOption, Int)] -> AddrInfo -> IO Socket