Copyright	(c) Lars Petersen 2015
License	MIT
Maintainer	info@lars-petersen.net
Stability	experimental
Safe Haskell	None
Language	Haskell2010

System.Socket.Family.Inet

Contents

Inet
Custom addresses
- inetAddressFromTuple
- inetAddressToTuple
Special addresses

Description

Synopsis

Inet

data Inet Source #

The Internet Protocol version 4.

Instances

Family Inet Source #
Methods familyNumber :: Inet -> CInt Source #
HasNameInfo Inet Source #
Methods getNameInfo :: SocketAddress Inet -> NameInfoFlags -> IO NameInfo Source #
HasAddressInfo Inet Source #
Methods getAddressInfo :: (Type t, Protocol p) => Maybe ByteString -> Maybe ByteString -> AddressInfoFlags -> IO [AddressInfo Inet t p] Source #
Eq (SocketAddress Inet) Source #
Methods (==) :: SocketAddress Inet -> SocketAddress Inet -> Bool # (/=) :: SocketAddress Inet -> SocketAddress Inet -> Bool #
Show (SocketAddress Inet) Source #
Methods showsPrec :: Int -> SocketAddress Inet -> ShowS # show :: SocketAddress Inet -> String # showList :: [SocketAddress Inet] -> ShowS #
Storable (SocketAddress Inet) Source #
Methods sizeOf :: SocketAddress Inet -> Int # alignment :: SocketAddress Inet -> Int # peekElemOff :: Ptr (SocketAddress Inet) -> Int -> IO (SocketAddress Inet) # pokeElemOff :: Ptr (SocketAddress Inet) -> Int -> SocketAddress Inet -> IO () # peekByteOff :: Ptr b -> Int -> IO (SocketAddress Inet) # pokeByteOff :: Ptr b -> Int -> SocketAddress Inet -> IO () # peek :: Ptr (SocketAddress Inet) -> IO (SocketAddress Inet) # poke :: Ptr (SocketAddress Inet) -> SocketAddress Inet -> IO () #
data SocketAddress Inet Source #	An IPv4 socket address. The socket address contains a port number that may be used by transport protocols like TCP. SocketAddressInet inetLoopback 8080
data SocketAddress Inet = SocketAddressInet { inetAddress :: InetAddress inetPort :: InetPort }

InetAddress

data InetAddress Source #

To avoid errors with endianess it was decided to keep this type abstract.

Use inetAddressFromTuple and inetAddressToTuple for constructing and deconstructing custom addresses.

Hint: Use the Storable instance. It exposes it exactly as found within an IP packet (big endian if you insist on interpreting it as a number).

Another hint: Use getAddressInfo for parsing and suppress nameserver lookups:

> getAddressInfo (Just "127.0.0.1") Nothing aiNumericHost :: IO [AddressInfo Inet Stream TCP]
[AddressInfo {addressInfoFlags = AddressInfoFlags 4, socketAddress = SocketAddressInet {inetAddress = InetAddress 127.0.0.1, inetPort = InetPort 0}, canonicalName = Nothing}]

Instances

Eq InetAddress Source #
Methods (==) :: InetAddress -> InetAddress -> Bool # (/=) :: InetAddress -> InetAddress -> Bool #
Show InetAddress Source #
Methods showsPrec :: Int -> InetAddress -> ShowS # show :: InetAddress -> String # showList :: [InetAddress] -> ShowS #
Storable InetAddress Source #
Methods sizeOf :: InetAddress -> Int # alignment :: InetAddress -> Int # peekElemOff :: Ptr InetAddress -> Int -> IO InetAddress # pokeElemOff :: Ptr InetAddress -> Int -> InetAddress -> IO () # peekByteOff :: Ptr b -> Int -> IO InetAddress # pokeByteOff :: Ptr b -> Int -> InetAddress -> IO () # peek :: Ptr InetAddress -> IO InetAddress # poke :: Ptr InetAddress -> InetAddress -> IO () #

InetPort

data InetPort Source #

Instances

Eq InetPort Source #
Methods (==) :: InetPort -> InetPort -> Bool # (/=) :: InetPort -> InetPort -> Bool #
Num InetPort Source #
Methods (+) :: InetPort -> InetPort -> InetPort # (-) :: InetPort -> InetPort -> InetPort # (*) :: InetPort -> InetPort -> InetPort # negate :: InetPort -> InetPort # abs :: InetPort -> InetPort # signum :: InetPort -> InetPort # fromInteger :: Integer -> InetPort #
Ord InetPort Source #
Methods compare :: InetPort -> InetPort -> Ordering # (<) :: InetPort -> InetPort -> Bool # (<=) :: InetPort -> InetPort -> Bool # (>) :: InetPort -> InetPort -> Bool # (>=) :: InetPort -> InetPort -> Bool # max :: InetPort -> InetPort -> InetPort # min :: InetPort -> InetPort -> InetPort #
Show InetPort Source #
Methods showsPrec :: Int -> InetPort -> ShowS # show :: InetPort -> String # showList :: [InetPort] -> ShowS #
Storable InetPort Source #
Methods sizeOf :: InetPort -> Int # alignment :: InetPort -> Int # peekElemOff :: Ptr InetPort -> Int -> IO InetPort # pokeElemOff :: Ptr InetPort -> Int -> InetPort -> IO () # peekByteOff :: Ptr b -> Int -> IO InetPort # pokeByteOff :: Ptr b -> Int -> InetPort -> IO () # peek :: Ptr InetPort -> IO InetPort # poke :: Ptr InetPort -> InetPort -> IO () #

SocketAddress Inet

data family SocketAddress f Source #

The SocketAddress type is a data family. This allows to provide different data constructors depending on the socket family wihtout knowing all of them in advance or the need to patch this core library.

SocketAddressInet  inetLoopback  8080     :: SocketAddress Inet
SocketAddressInet6 inet6Loopback 8080 0 0 :: SocketAddress Inet6

Instances

Eq (SocketAddress Inet6) #
Methods (==) :: SocketAddress Inet6 -> SocketAddress Inet6 -> Bool # (/=) :: SocketAddress Inet6 -> SocketAddress Inet6 -> Bool #
Eq (SocketAddress Inet) #
Methods (==) :: SocketAddress Inet -> SocketAddress Inet -> Bool # (/=) :: SocketAddress Inet -> SocketAddress Inet -> Bool #
Show (SocketAddress Inet6) #
Methods showsPrec :: Int -> SocketAddress Inet6 -> ShowS # show :: SocketAddress Inet6 -> String # showList :: [SocketAddress Inet6] -> ShowS #
Show (SocketAddress Inet) #
Methods showsPrec :: Int -> SocketAddress Inet -> ShowS # show :: SocketAddress Inet -> String # showList :: [SocketAddress Inet] -> ShowS #
Storable (SocketAddress Inet6) #
Methods sizeOf :: SocketAddress Inet6 -> Int # alignment :: SocketAddress Inet6 -> Int # peekElemOff :: Ptr (SocketAddress Inet6) -> Int -> IO (SocketAddress Inet6) # pokeElemOff :: Ptr (SocketAddress Inet6) -> Int -> SocketAddress Inet6 -> IO () # peekByteOff :: Ptr b -> Int -> IO (SocketAddress Inet6) # pokeByteOff :: Ptr b -> Int -> SocketAddress Inet6 -> IO () # peek :: Ptr (SocketAddress Inet6) -> IO (SocketAddress Inet6) # poke :: Ptr (SocketAddress Inet6) -> SocketAddress Inet6 -> IO () #
Storable (SocketAddress Inet) #
Methods sizeOf :: SocketAddress Inet -> Int # alignment :: SocketAddress Inet -> Int # peekElemOff :: Ptr (SocketAddress Inet) -> Int -> IO (SocketAddress Inet) # pokeElemOff :: Ptr (SocketAddress Inet) -> Int -> SocketAddress Inet -> IO () # peekByteOff :: Ptr b -> Int -> IO (SocketAddress Inet) # pokeByteOff :: Ptr b -> Int -> SocketAddress Inet -> IO () # peek :: Ptr (SocketAddress Inet) -> IO (SocketAddress Inet) # poke :: Ptr (SocketAddress Inet) -> SocketAddress Inet -> IO () #
data SocketAddress Inet6 Source #	An IPv6 socket address. The socket address contains a port number that may be used by transport protocols like TCP. SocketAddressInet6 inet6Loopback 8080 0 0
data SocketAddress Inet6 = SocketAddressInet6 { inet6Address :: Inet6Address inet6Port :: Inet6Port inet6FlowInfo :: Inet6FlowInfo inet6ScopeId :: Inet6ScopeId }
data SocketAddress Inet Source #	An IPv4 socket address. The socket address contains a port number that may be used by transport protocols like TCP. SocketAddressInet inetLoopback 8080
data SocketAddress Inet = SocketAddressInet { inetAddress :: InetAddress inetPort :: InetPort }

Custom addresses

inetAddressFromTuple

inetAddressFromTuple :: (Word8, Word8, Word8, Word8) -> InetAddress Source #

Constructs a custom InetAddress.

inetAddressFromTuple (127,0,0,1) == inetLoopback

inetAddressToTuple

inetAddressToTuple :: InetAddress -> (Word8, Word8, Word8, Word8) Source #

Deconstructs an InetAddress.

Special addresses

inetAllHostsGroup

inetAllHostsGroup :: InetAddress Source #

224.0.0.1

inetAny

inetAny :: InetAddress Source #

0.0.0.0

inetBroadcast

inetBroadcast :: InetAddress Source #

255.255.255.255

inetLoopback

inetLoopback :: InetAddress Source #

127.0.0.1

inetMaxLocalGroup

inetMaxLocalGroup :: InetAddress Source #

224.0.0.255

inetNone

inetNone :: InetAddress Source #

255.255.255.255

inetUnspecificGroup

inetUnspecificGroup :: InetAddress Source #

224.0.0.0