Network.DNS.Common

Documentation

htonl :: Word32 -> Word32

data QueryType

Types of DNS queries. RFC 1035, 4.1.1.

Constructors

QUERY

IQUERY

SERVERSTATUS

Instances

Bounded QueryType

Enum QueryType

Eq QueryType

Show QueryType

parseEnum :: forall m a. (Enum a, Bounded a, Monad m) => Word8 -> m a

Parse an enum from a Word8 in a monad and fail if the value is out of range. It's assumed that the enum is defined at every value between the min and max bound

data Header

A DNS protocol header. RFC 1035, 4.1.1.

Constructors

Header

Fields

headId :: Word16

headIsResponse :: Bool

headOpCode :: QueryType

headIsAuthoritative :: Bool

headIsTruncated :: Bool

headRecursionDesired :: Bool

headRecursionAvailible :: Bool

headResponseCode :: ResponseCode

headQuestionCount :: Int

headAnswerCount :: Int

headNSCount :: Int

headAdditionalCount :: Int

Instances

Eq Header

Show Header

parseHeader :: Get Header

serialiseHeader :: Header -> Put

splitDNSName :: String -> [String]

Break a DNS name (e.g. www.google.com) into a list of labels

serialiseDNSName :: [String] -> Maybe ByteString

Convert a split name into the length-prefixed DNS wire format. FIXME: should work with the IDNA system. Returns Nothing if the name couldn't be serialised. FIXME: catch invalid charactors and > 255 parts

fromDNSName :: [String] -> String

Convert a list of labels to a normal string by interspersing periods

parseDNSName :: ByteString -> Get [String]

serialiseQuestion

Arguments

:: ByteString

the encoded name (see serialiseDNSName)

-> DNSType

the type of the question

-> Put

parseQuestion :: ByteString -> Get (String, DNSType)

parseDNSType :: Get DNSType

deserialiseQuestion :: ByteString -> Get ([String], DNSType)

parseGenericRR :: ByteString -> Get ([String], DNSType, Word32, ByteString)

type Entry = ([String], Word32, RR)

parseRR :: ByteString -> Get Entry

data Packet

Constructors

Packet Header [(String, DNSType)] [Entry] [Entry] [Entry]

Instances

Show Packet

parsePacket :: ByteString -> Either String Packet