Z.IO.Network.SocketAddr

This module provides necessary types and constant for low level socket address manipulating.

name to address

data SocketAddr

IPv4 or IPv6 socket address, i.e. the sockaddr_in or sockaddr_in6 struct.

Constructors

SocketAddrInet !PortNumber !InetAddr

SocketAddrInet6 !PortNumber !FlowInfo !Inet6Addr !ScopeID

Instances

Eq SocketAddr

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: SocketAddr -> SocketAddr -> Bool

(/=) :: SocketAddr -> SocketAddr -> Bool

Ord SocketAddr

Defined in Z.IO.Network.SocketAddr

Methods

compare :: SocketAddr -> SocketAddr -> Ordering

(<) :: SocketAddr -> SocketAddr -> Bool

(<=) :: SocketAddr -> SocketAddr -> Bool

(>) :: SocketAddr -> SocketAddr -> Bool

(>=) :: SocketAddr -> SocketAddr -> Bool

max :: SocketAddr -> SocketAddr -> SocketAddr

min :: SocketAddr -> SocketAddr -> SocketAddr

Show SocketAddr

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> SocketAddr -> ShowS

show :: SocketAddr -> String

showList :: [SocketAddr] -> ShowS

sockAddrFamily :: SocketAddr -> SocketFamily

Show an IPv6 address in the most appropriate notation, based on recommended representation proposed by RFC 5952.

/The implementation is completely compatible with the current implementation of the inet_ntop function in glibc./

peekSocketAddr :: HasCallStack => Ptr SocketAddr -> IO SocketAddr

withSocketAddr :: SocketAddr -> (Ptr SocketAddr -> IO a) -> IO a

sizeOfSocketAddr :: SocketAddr -> CSize

withSocketAddrStorage :: (Ptr SocketAddr -> IO ()) -> IO SocketAddr

sizeOfSocketAddrStorage :: CSize

IPv4 address

data InetAddr

Independent of endianness. For example 127.0.0.1 is stored as (127, 0, 0, 1).

For direct manipulation prefer inetAddrToTuple and tupleToInetAddr.

Instances

Eq InetAddr

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: InetAddr -> InetAddr -> Bool

(/=) :: InetAddr -> InetAddr -> Bool

Ord InetAddr

Defined in Z.IO.Network.SocketAddr

Methods

compare :: InetAddr -> InetAddr -> Ordering

(<) :: InetAddr -> InetAddr -> Bool

(<=) :: InetAddr -> InetAddr -> Bool

(>) :: InetAddr -> InetAddr -> Bool

(>=) :: InetAddr -> InetAddr -> Bool

max :: InetAddr -> InetAddr -> InetAddr

min :: InetAddr -> InetAddr -> InetAddr

Show InetAddr

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> InetAddr -> ShowS

show :: InetAddr -> String

showList :: [InetAddr] -> ShowS

Storable InetAddr

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: InetAddr -> Int

alignment :: InetAddr -> Int

peekElemOff :: Ptr InetAddr -> Int -> IO InetAddr

pokeElemOff :: Ptr InetAddr -> Int -> InetAddr -> IO ()

peekByteOff :: Ptr b -> Int -> IO InetAddr

pokeByteOff :: Ptr b -> Int -> InetAddr -> IO ()

peek :: Ptr InetAddr -> IO InetAddr

poke :: Ptr InetAddr -> InetAddr -> IO ()

inetAny :: InetAddr

0.0.0.0

inetBroadcast :: InetAddr

255.255.255.255

inetNone :: InetAddr

255.255.255.255

inetLoopback :: InetAddr

127.0.0.1

inetUnspecificGroup :: InetAddr

224.0.0.0

inetAllHostsGroup :: InetAddr

224.0.0.1

inetMaxLocalGroup :: InetAddr

224.0.0.255

inetAddrToTuple :: InetAddr -> (Word8, Word8, Word8, Word8)

Converts InetAddr to representation-independent IPv4 quadruple. For example for 127.0.0.1 the function will return (127, 0, 0, 1) regardless of host endianness.

tupleToInetAddr :: (Word8, Word8, Word8, Word8) -> InetAddr

Converts IPv4 quadruple to InetAddr.

IPv6 address

data Inet6Addr

Independent of endianness. For example ::1 is stored as (0, 0, 0, 1).

For direct manipulation prefer inet6AddrToTuple and tupleToInet6Addr.

Instances

Eq Inet6Addr

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: Inet6Addr -> Inet6Addr -> Bool

(/=) :: Inet6Addr -> Inet6Addr -> Bool

Ord Inet6Addr

Defined in Z.IO.Network.SocketAddr

Methods

compare :: Inet6Addr -> Inet6Addr -> Ordering

(<) :: Inet6Addr -> Inet6Addr -> Bool

(<=) :: Inet6Addr -> Inet6Addr -> Bool

(>) :: Inet6Addr -> Inet6Addr -> Bool

(>=) :: Inet6Addr -> Inet6Addr -> Bool

max :: Inet6Addr -> Inet6Addr -> Inet6Addr

min :: Inet6Addr -> Inet6Addr -> Inet6Addr

Show Inet6Addr

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> Inet6Addr -> ShowS

show :: Inet6Addr -> String

showList :: [Inet6Addr] -> ShowS

Storable Inet6Addr

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: Inet6Addr -> Int

alignment :: Inet6Addr -> Int

peekElemOff :: Ptr Inet6Addr -> Int -> IO Inet6Addr

pokeElemOff :: Ptr Inet6Addr -> Int -> Inet6Addr -> IO ()

peekByteOff :: Ptr b -> Int -> IO Inet6Addr

pokeByteOff :: Ptr b -> Int -> Inet6Addr -> IO ()

peek :: Ptr Inet6Addr -> IO Inet6Addr

poke :: Ptr Inet6Addr -> Inet6Addr -> IO ()

inet6Any :: Inet6Addr

::

inet6Loopback :: Inet6Addr

::1

inet6AddrToTuple :: Inet6Addr -> (Word16, Word16, Word16, Word16, Word16, Word16, Word16, Word16)

tupleToInet6Addr :: (Word16, Word16, Word16, Word16, Word16, Word16, Word16, Word16) -> Inet6Addr

type FlowInfo = Word32

type ScopeID = Word32

port numbber

data PortNumber

Use the Num instance (i.e. use a literal or fromIntegral) to create a PortNumber value with the correct network-byte-ordering.

>>> 1 :: PortNumber
1
>>> read "1" :: PortNumber
1

Instances

Enum PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

succ :: PortNumber -> PortNumber

pred :: PortNumber -> PortNumber

toEnum :: Int -> PortNumber

fromEnum :: PortNumber -> Int

enumFrom :: PortNumber -> [PortNumber]

enumFromThen :: PortNumber -> PortNumber -> [PortNumber]

enumFromTo :: PortNumber -> PortNumber -> [PortNumber]

enumFromThenTo :: PortNumber -> PortNumber -> PortNumber -> [PortNumber]

Eq PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: PortNumber -> PortNumber -> Bool

(/=) :: PortNumber -> PortNumber -> Bool

Integral PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

quot :: PortNumber -> PortNumber -> PortNumber

rem :: PortNumber -> PortNumber -> PortNumber

div :: PortNumber -> PortNumber -> PortNumber

mod :: PortNumber -> PortNumber -> PortNumber

quotRem :: PortNumber -> PortNumber -> (PortNumber, PortNumber)

divMod :: PortNumber -> PortNumber -> (PortNumber, PortNumber)

toInteger :: PortNumber -> Integer

Num PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

(+) :: PortNumber -> PortNumber -> PortNumber

(-) :: PortNumber -> PortNumber -> PortNumber

(*) :: PortNumber -> PortNumber -> PortNumber

negate :: PortNumber -> PortNumber

abs :: PortNumber -> PortNumber

signum :: PortNumber -> PortNumber

fromInteger :: Integer -> PortNumber

Ord PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

compare :: PortNumber -> PortNumber -> Ordering

(<) :: PortNumber -> PortNumber -> Bool

(<=) :: PortNumber -> PortNumber -> Bool

(>) :: PortNumber -> PortNumber -> Bool

(>=) :: PortNumber -> PortNumber -> Bool

max :: PortNumber -> PortNumber -> PortNumber

min :: PortNumber -> PortNumber -> PortNumber

Read PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

readsPrec :: Int -> ReadS PortNumber

readList :: ReadS [PortNumber]

readPrec :: ReadPrec PortNumber

readListPrec :: ReadPrec [PortNumber]

Real PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

toRational :: PortNumber -> Rational

Show PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> PortNumber -> ShowS

show :: PortNumber -> String

showList :: [PortNumber] -> ShowS

Storable PortNumber

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: PortNumber -> Int

alignment :: PortNumber -> Int

peekElemOff :: Ptr PortNumber -> Int -> IO PortNumber

pokeElemOff :: Ptr PortNumber -> Int -> PortNumber -> IO ()

peekByteOff :: Ptr b -> Int -> IO PortNumber

pokeByteOff :: Ptr b -> Int -> PortNumber -> IO ()

peek :: Ptr PortNumber -> IO PortNumber

poke :: Ptr PortNumber -> PortNumber -> IO ()

portAny :: PortNumber

htons :: Word16 -> Word16

ntohs :: Word16 -> Word16

ntohl :: Word32 -> Word32

htonl :: Word32 -> Word32

family, type, protocol

newtype SocketFamily

Constructors

SocketFamily CInt

Instances

Eq SocketFamily

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: SocketFamily -> SocketFamily -> Bool

(/=) :: SocketFamily -> SocketFamily -> Bool

Ord SocketFamily

Defined in Z.IO.Network.SocketAddr

Methods

compare :: SocketFamily -> SocketFamily -> Ordering

(<) :: SocketFamily -> SocketFamily -> Bool

(<=) :: SocketFamily -> SocketFamily -> Bool

(>) :: SocketFamily -> SocketFamily -> Bool

(>=) :: SocketFamily -> SocketFamily -> Bool

max :: SocketFamily -> SocketFamily -> SocketFamily

min :: SocketFamily -> SocketFamily -> SocketFamily

Read SocketFamily

Defined in Z.IO.Network.SocketAddr

Methods

readsPrec :: Int -> ReadS SocketFamily

readList :: ReadS [SocketFamily]

readPrec :: ReadPrec SocketFamily

readListPrec :: ReadPrec [SocketFamily]

Show SocketFamily

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> SocketFamily -> ShowS

show :: SocketFamily -> String

showList :: [SocketFamily] -> ShowS

Storable SocketFamily

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: SocketFamily -> Int

alignment :: SocketFamily -> Int

peekElemOff :: Ptr SocketFamily -> Int -> IO SocketFamily

pokeElemOff :: Ptr SocketFamily -> Int -> SocketFamily -> IO ()

peekByteOff :: Ptr b -> Int -> IO SocketFamily

pokeByteOff :: Ptr b -> Int -> SocketFamily -> IO ()

peek :: Ptr SocketFamily -> IO SocketFamily

poke :: Ptr SocketFamily -> SocketFamily -> IO ()

pattern AF_UNSPEC :: SocketFamily

unspecified

pattern AF_INET :: SocketFamily

internetwork: UDP, TCP, etc

pattern AF_INET6 :: SocketFamily

Internet Protocol version 6

newtype SocketType

Constructors

SocketType CInt

Instances

Eq SocketType

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: SocketType -> SocketType -> Bool

(/=) :: SocketType -> SocketType -> Bool

Ord SocketType

Defined in Z.IO.Network.SocketAddr

Methods

compare :: SocketType -> SocketType -> Ordering

(<) :: SocketType -> SocketType -> Bool

(<=) :: SocketType -> SocketType -> Bool

(>) :: SocketType -> SocketType -> Bool

(>=) :: SocketType -> SocketType -> Bool

max :: SocketType -> SocketType -> SocketType

min :: SocketType -> SocketType -> SocketType

Read SocketType

Defined in Z.IO.Network.SocketAddr

Methods

readsPrec :: Int -> ReadS SocketType

readList :: ReadS [SocketType]

readPrec :: ReadPrec SocketType

readListPrec :: ReadPrec [SocketType]

Show SocketType

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> SocketType -> ShowS

show :: SocketType -> String

showList :: [SocketType] -> ShowS

Storable SocketType

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: SocketType -> Int

alignment :: SocketType -> Int

peekElemOff :: Ptr SocketType -> Int -> IO SocketType

pokeElemOff :: Ptr SocketType -> Int -> SocketType -> IO ()

peekByteOff :: Ptr b -> Int -> IO SocketType

pokeByteOff :: Ptr b -> Int -> SocketType -> IO ()

peek :: Ptr SocketType -> IO SocketType

poke :: Ptr SocketType -> SocketType -> IO ()

pattern SOCK_DGRAM :: SocketType

pattern SOCK_STREAM :: SocketType

pattern SOCK_SEQPACKET :: SocketType

pattern SOCK_RAW :: SocketType

pattern SOCK_RDM :: SocketType

pattern SOCK_ANY :: SocketType

Used in getAddrInfo hints, for any type can be returned by getAddrInfo

newtype ProtocolNumber

Constructors

ProtocolNumber CInt

Instances

Eq ProtocolNumber

Defined in Z.IO.Network.SocketAddr

Methods

(==) :: ProtocolNumber -> ProtocolNumber -> Bool

(/=) :: ProtocolNumber -> ProtocolNumber -> Bool

Ord ProtocolNumber

Defined in Z.IO.Network.SocketAddr

Methods

compare :: ProtocolNumber -> ProtocolNumber -> Ordering

(<) :: ProtocolNumber -> ProtocolNumber -> Bool

(<=) :: ProtocolNumber -> ProtocolNumber -> Bool

(>) :: ProtocolNumber -> ProtocolNumber -> Bool

(>=) :: ProtocolNumber -> ProtocolNumber -> Bool

max :: ProtocolNumber -> ProtocolNumber -> ProtocolNumber

min :: ProtocolNumber -> ProtocolNumber -> ProtocolNumber

Read ProtocolNumber

Defined in Z.IO.Network.SocketAddr

Methods

readsPrec :: Int -> ReadS ProtocolNumber

readList :: ReadS [ProtocolNumber]

readPrec :: ReadPrec ProtocolNumber

readListPrec :: ReadPrec [ProtocolNumber]

Show ProtocolNumber

Defined in Z.IO.Network.SocketAddr

Methods

showsPrec :: Int -> ProtocolNumber -> ShowS

show :: ProtocolNumber -> String

showList :: [ProtocolNumber] -> ShowS

Storable ProtocolNumber

Defined in Z.IO.Network.SocketAddr

Methods

sizeOf :: ProtocolNumber -> Int

alignment :: ProtocolNumber -> Int

peekElemOff :: Ptr ProtocolNumber -> Int -> IO ProtocolNumber

pokeElemOff :: Ptr ProtocolNumber -> Int -> ProtocolNumber -> IO ()

peekByteOff :: Ptr b -> Int -> IO ProtocolNumber

pokeByteOff :: Ptr b -> Int -> ProtocolNumber -> IO ()

peek :: Ptr ProtocolNumber -> IO ProtocolNumber

poke :: Ptr ProtocolNumber -> ProtocolNumber -> IO ()

pattern IPPROTO_DEFAULT :: ProtocolNumber

pattern IPPROTO_IP :: ProtocolNumber

pattern IPPROTO_TCP :: ProtocolNumber

pattern IPPROTO_UDP :: ProtocolNumber