{-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} -- | Simple functions to run TCP clients and servers. module Network.Run.TCP ( -- * Server runTCPServer, runTCPServerWithSocket, openTCPServerSocket, openTCPServerSocketWithOptions, openTCPServerSocketWithOpts, resolve, -- * Client runTCPClient, Settings, defaultSettings, settingsOpenClientSocket, runTCPClientWithSettings, openClientSocket, openClientSocketWithOptions, openClientSocketWithOpts, ) where import Control.Concurrent (forkFinally, threadDelay, forkIO) import qualified Control.Exception as E import Control.Monad (forever, void) import Network.Socket import Network.Run.Core ---------------------------------------------------------------- -- | Running a TCP server with an accepted socket and its peer name. runTCPServer :: Maybe HostName -> ServiceName -> (Socket -> IO a) -> IO a runTCPServer mhost port server = withSocketsDo $ do addr <- resolve Stream mhost port [AI_PASSIVE] E.bracket (openTCPServerSocket addr) close $ \sock -> runTCPServerWithSocket sock server -- | Running a TCP client with a connected socket for a given listen -- socket. runTCPServerWithSocket :: Socket -> (Socket -> IO a) -- ^ Called for each incoming connection, in a new thread -> IO a runTCPServerWithSocket sock server = withSocketsDo $ forever $ E.bracketOnError (accept sock) (close . fst) $ \(conn, _peer) -> void $ forkFinally (labelMe "TCP server" >> server conn) (const $ gclose conn) ---------------------------------------------------------------- -- | Settings for client. data Settings = Settings { settingsOpenClientSocket :: AddrInfo -> IO Socket -- ^ Opening a socket. Use 'openClientSocketWithOptions' to specify 'SocketOption' } -- | Default settings. defaultSettings :: Settings defaultSettings = Settings { settingsOpenClientSocket = openClientSocket } -- | Running a TCP client with a connected socket. -- -- This is the same as: -- -- @ -- 'runTCPClientWithSettings' 'defaultSettings' -- @ runTCPClient :: HostName -> ServiceName -> (Socket -> IO a) -> IO a runTCPClient = runTCPClientWithSettings defaultSettings -- | Running a TCP client with a connected socket. runTCPClientWithSettings :: Settings -> HostName -> ServiceName -> (Socket -> IO a) -> IO a runTCPClientWithSettings Settings{..} host port client = withSocketsDo $ do addr <- resolve Stream (Just host) port [AI_ADDRCONFIG] E.bracket (settingsOpenClientSocket addr) close client