-- |-- Module : Network.Socket.ByteString-- Copyright : (c) Johan Tibell 2007-2010-- License : BSD-style---- Maintainer : johan.tibell@gmail.com-- Stability : stable-- Portability : portable---- This module provides access to the BSD /socket/ interface. For detailed-- documentation, consult your favorite POSIX socket reference. All functions-- communicate failures by converting the error number to an-- 'System.IO.Error.IOError'.---- This module is made to be imported with "Network.Socket" like so:---- > import Network.Socket-- > import Network.Socket.ByteString--moduleNetwork.Socket.ByteString(-- * Send data to a socketsend ,sendAll ,sendTo ,sendAllTo -- ** Vectored I/O-- $vectored,sendMany ,sendManyTo -- * Receive data from a socket,recv ,recvFrom -- * Advanced send and recv,sendMsg ,recvMsg )whereimportData.ByteString(ByteString)importqualifiedNetwork.Socket.ByteString.IO asGimportNetwork.Socket.ByteString.IO hiding(sendTo ,sendAllTo ,recvFrom )importNetwork.Socket.Types -- ------------------------------------------------------------------------------ ** Vectored I/O-- $vectored---- Vectored I\/O, also known as scatter\/gather I\/O, allows multiple-- data segments to be sent using a single system call, without first-- concatenating the segments. For example, given a list of-- @ByteString@s, @xs@,---- > sendMany sock xs---- is equivalent to---- > sendAll sock (concat xs)---- but potentially more efficient.---- Vectored I\/O are often useful when implementing network protocols-- that, for example, group data into segments consisting of one or-- more fixed-length headers followed by a variable-length body.-- | Send data to the socket. The recipient can be specified-- explicitly, so the socket need not be in a connected state.-- Returns the number of bytes sent. Applications are responsible for-- ensuring that all data has been sent.sendTo ::Socket ->ByteString->SockAddr ->IOIntsendTo :: Socket -> ByteString -> SockAddr -> IO Int
sendTo =Socket -> ByteString -> SockAddr -> IO Int
forall sa. SocketAddress sa => Socket -> ByteString -> sa -> IO Int
G.sendTo -- | Send data to the socket. The recipient can be specified-- explicitly, so the socket need not be in a connected state. Unlike-- 'sendTo', this function continues to send data until either all-- data has been sent or an error occurs. On error, an exception is-- raised, and there is no way to determine how much data, if any, was-- successfully sent.sendAllTo ::Socket ->ByteString->SockAddr ->IO()sendAllTo :: Socket -> ByteString -> SockAddr -> IO ()
sendAllTo =Socket -> ByteString -> SockAddr -> IO ()
forall sa. SocketAddress sa => Socket -> ByteString -> sa -> IO ()
G.sendAllTo -- | Receive data from the socket. The socket need not be in a-- connected state. Returns @(bytes, address)@ where @bytes@ is a-- 'ByteString' representing the data received and @address@ is a-- 'SockAddr' representing the address of the sending socket.recvFrom ::Socket ->Int->IO(ByteString,SockAddr )recvFrom :: Socket -> Int -> IO (ByteString, SockAddr)
recvFrom =Socket -> Int -> IO (ByteString, SockAddr)
forall sa. SocketAddress sa => Socket -> Int -> IO (ByteString, sa)
G.recvFrom