-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Simple network runner library
--   
--   Simple functions to run network clients and servers.
@package network-run
@version 0.4.4


-- | Simple functions to run TCP clients and servers.
module Network.Run.TCP

-- | Running a TCP server with an accepted socket and its peer name.
runTCPServer :: Maybe HostName -> ServiceName -> (Socket -> IO a) -> IO a

-- | Running a TCP client with a connected socket for a given listen
--   socket.
runTCPServerWithSocket :: Socket -> (Socket -> IO a) -> IO a

-- | Open TCP socket for server use
--   
--   This is the same as:
--   
--   <pre>
--   <a>openTCPServerSocketWithOptions</a> []
--   </pre>
openTCPServerSocket :: AddrInfo -> IO Socket

-- | Open socket for server use, and set the provided options before
--   binding.
--   
--   This is equivalent to
--   
--   <pre>
--   <a>openTCPServerSocketWithOpts</a> . <a>map</a> (<a>second</a> <a>SockOptValue</a>)
--   </pre>
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
--   
--   <ul>
--   <li>allow reuse of local addresses (SO_REUSEADDR)</li>
--   <li>automatically be closed during a successful <tt>execve</tt>
--   (FD_CLOEXEC)</li>
--   <li>bind to the address specified</li>
--   <li>listen with queue length with 1024</li>
--   </ul>
openTCPServerSocketWithOpts :: [(SocketOption, SockOptValue)] -> AddrInfo -> IO Socket
resolve :: SocketType -> Maybe HostName -> ServiceName -> [AddrInfoFlag] -> (NonEmpty AddrInfo -> AddrInfo) -> IO AddrInfo

-- | Running a TCP client with a connected socket.
--   
--   This is the same as:
--   
--   <pre>
--   <a>runTCPClientWithSettings</a> <a>defaultSettings</a>
--   </pre>
runTCPClient :: HostName -> ServiceName -> (Socket -> IO a) -> IO a

-- | Settings for client.
data Settings

-- | Default settings.
defaultSettings :: Settings

-- | Opening a socket. Use <a>openClientSocketWithOptions</a> to specify
--   <a>SocketOption</a>
settingsOpenClientSocket :: Settings -> AddrInfo -> IO Socket

-- | Selecting <a>AddrInfo</a>.
settingsSelectAddrInfo :: Settings -> NonEmpty AddrInfo -> AddrInfo

-- | Running a TCP client with a connected socket.
runTCPClientWithSettings :: Settings -> HostName -> ServiceName -> (Socket -> IO a) -> IO a

-- | This is the same as
--   
--   <pre>
--   <a>openClientSocketWithOptions</a> []
--   </pre>
openClientSocket :: AddrInfo -> IO Socket

-- | Open a client socket with the given options
--   
--   The options are set before <a>connect</a>. This is equivalent to
--   
--   <pre>
--   <a>openClientSocketWithOpts</a> . <a>map</a> (<a>second</a> <a>SockOptValue</a>)
--   </pre>
openClientSocketWithOptions :: [(SocketOption, Int)] -> AddrInfo -> IO Socket

-- | Open a client socket with the given options
--   
--   This must be used rather than <a>openClientSocketWithOptions</a> for
--   options such as <a>Linger</a> which require a composite value
--   (<a>StructLinger</a>).
--   
--   The options are set before <a>connect</a>.
openClientSocketWithOpts :: [(SocketOption, SockOptValue)] -> AddrInfo -> IO Socket


-- | Simple functions to run TCP clients and servers.
module Network.Run.TCP.Timeout

-- | Running a TCP server with a connected socket.
runTCPServer :: Int -> Maybe HostName -> ServiceName -> TimeoutServer a -> IO a

-- | A server type
type TimeoutServer a = Manager -> Handle -> Socket -> IO a

-- | Running a TCP client with a connected socket for a given listen
--   socket.
runTCPServerWithSocket :: Int -> Socket -> TimeoutServer a -> IO a

-- | Open socket for server use
--   
--   This is the same as:
--   
--   <pre>
--   <a>openServerSocketWithOptions</a> []
--   </pre>
openServerSocket :: AddrInfo -> IO Socket

-- | Open socket for server use, and set the provided options before
--   binding.
--   
--   This is equivalent to
--   
--   <pre>
--   <a>openServerSocketWithOpts</a> . <a>map</a> (<a>second</a> <a>SockOptValue</a>)
--   </pre>
openServerSocketWithOptions :: [(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
--   
--   <ul>
--   <li>allow reuse of local addresses (SO_REUSEADDR)</li>
--   <li>automatically be closed during a successful <tt>execve</tt>
--   (FD_CLOEXEC)</li>
--   <li>bind to the address specified</li>
--   </ul>
openServerSocketWithOpts :: [(SocketOption, SockOptValue)] -> AddrInfo -> IO Socket


-- | Simple functions to run UDP clients and servers.
module Network.Run.UDP

-- | Running a UDP client with a socket. The client action takes a socket
--   and server's socket address. They should be used with <a>sendTo</a>.
runUDPClient :: HostName -> ServiceName -> (Socket -> SockAddr -> IO a) -> IO a

-- | Running a UDP server with an open socket in a single Haskell thread.
runUDPServer :: Maybe HostName -> ServiceName -> (Socket -> IO a) -> IO a

-- | Running a UDP server with a connected socket in each Haskell thread.
--   The first request is given to the server. Suppose that the server is
--   serving on <b>addrS:portS</b> and a client connects to the service
--   from <b>addrC:portC</b>. A connected socket is created by binding to
--   <b>*:portS</b> and connecting to <b>addrC:portC</b>, resulting in
--   <b>(UDP,addrS:portS,addrC:portC)</b> where <b>addrS</b> is given
--   magically. This approach is fragile due to NAT rebidings.
runUDPServerFork :: [HostName] -> ServiceName -> (Socket -> ByteString -> IO ()) -> IO ()
