dnsbase
Copyright(c) Viktor Dukhovni 2026
LicenseBSD-3-Clause
Maintainerietf-dane@dukhovni.org
Stabilityunstable
Safe HaskellNone
LanguageGHC2024

Net.DNSBase.RData.WKS

Description

The WKS resource record predates port-by-port service discovery conventions and was effectively obsoleted by them. It is defined here so wire-form parsers can read stray WKS records in zone data without failing; new deployments should not produce WKS.

Synopsis

Documentation

data T_wks Source #

The WKS resource record (RFC 1035 section 3.4.2), mapping an IPv4 address and a WksProto protocol number to the set of TCP/UDP port numbers (16-bit) on which the named host accepts connections. Ports are encoded on the wire as a packed bitmap whose length implies the maximum port carried.

 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
 |                    ADDRESS                    |
 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
 |       PROTOCOL        |                       |
 +--+--+--+--+--+--+--+--+                       |
 |                                               |
 /                   <BIT MAP>                   /
 /                                               /
 +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

The Ord instance compares by address, then protocol, then the port set in descending order — matching the byte-wise comparison of the wire-form port bitmap, so it agrees with the canonical RR-content ordering of RFC 4034 section 6.2.

Constructors

T_WKS 

Fields

Instances

Instances details
Presentable T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

present :: T_wks -> Builder -> Builder Source #

presentLazy :: T_wks -> ByteString -> ByteString Source #

KnownRData T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Associated Types

type RDataExtensionVal T_wks 
Instance details

Defined in Net.DNSBase.RData.WKS

type RDataExtensionVal T_wks = ()

Methods

rdataExtensionVal :: forall b -> b ~ T_wks => RDataExtensionVal T_wks Source #

rdType :: forall b -> b ~ T_wks => RRTYPE Source #

rdTypePres :: forall b -> b ~ T_wks => Builder -> Builder Source #

rdDecode :: forall b -> b ~ T_wks => RDataExtensionVal T_wks -> Int -> SGet RData Source #

rdEncode :: T_wks -> SPut s RData Source #

cnEncode :: T_wks -> SPut s RData Source #

Show T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

showsPrec :: Int -> T_wks -> ShowS #

show :: T_wks -> String #

showList :: [T_wks] -> ShowS #

Eq T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

(==) :: T_wks -> T_wks -> Bool #

(/=) :: T_wks -> T_wks -> Bool #

Ord T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

compare :: T_wks -> T_wks -> Ordering #

(<) :: T_wks -> T_wks -> Bool #

(<=) :: T_wks -> T_wks -> Bool #

(>) :: T_wks -> T_wks -> Bool #

(>=) :: T_wks -> T_wks -> Bool #

max :: T_wks -> T_wks -> T_wks #

min :: T_wks -> T_wks -> T_wks #

type RDataExtensionVal T_wks Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

type RDataExtensionVal T_wks = ()

newtype WksProto Source #

IP protocol number used in the T_wks header byte. Bidirectional patterns TCP (6) and UDP (17) cover the two protocols WKS was ever realistically used for; any other protocol number presents as its decimal value.

Constructors

WksProto Word8 

Bundled Patterns

pattern UDP :: WksProto 
pattern TCP :: WksProto 

Instances

Instances details
Presentable WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

present :: WksProto -> Builder -> Builder Source #

presentLazy :: WksProto -> ByteString -> ByteString Source #

Bounded WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

minBound :: WksProto #

maxBound :: WksProto #

Enum WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

succ :: WksProto -> WksProto #

pred :: WksProto -> WksProto #

toEnum :: Int -> WksProto #

fromEnum :: WksProto -> Int #

enumFrom :: WksProto -> [WksProto] #

enumFromThen :: WksProto -> WksProto -> [WksProto] #

enumFromTo :: WksProto -> WksProto -> [WksProto] #

enumFromThenTo :: WksProto -> WksProto -> WksProto -> [WksProto] #

Num WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

(+) :: WksProto -> WksProto -> WksProto #

(-) :: WksProto -> WksProto -> WksProto #

(*) :: WksProto -> WksProto -> WksProto #

negate :: WksProto -> WksProto #

abs :: WksProto -> WksProto #

signum :: WksProto -> WksProto #

fromInteger :: Integer -> WksProto #

Read WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

readsPrec :: Int -> ReadS WksProto #

readList :: ReadS [WksProto] #

readPrec :: ReadPrec WksProto #

readListPrec :: ReadPrec [WksProto] #

Integral WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

quot :: WksProto -> WksProto -> WksProto #

rem :: WksProto -> WksProto -> WksProto #

div :: WksProto -> WksProto -> WksProto #

mod :: WksProto -> WksProto -> WksProto #

quotRem :: WksProto -> WksProto -> (WksProto, WksProto) #

divMod :: WksProto -> WksProto -> (WksProto, WksProto) #

toInteger :: WksProto -> Integer #

Real WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

toRational :: WksProto -> Rational #

Show WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

showsPrec :: Int -> WksProto -> ShowS #

show :: WksProto -> String #

showList :: [WksProto] -> ShowS #

Eq WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

(==) :: WksProto -> WksProto -> Bool #

(/=) :: WksProto -> WksProto -> Bool #

Ord WksProto Source # 
Instance details

Defined in Net.DNSBase.RData.WKS

Methods

compare :: WksProto -> WksProto -> Ordering #

(<) :: WksProto -> WksProto -> Bool #

(<=) :: WksProto -> WksProto -> Bool #

(>) :: WksProto -> WksProto -> Bool #

(>=) :: WksProto -> WksProto -> Bool #

max :: WksProto -> WksProto -> WksProto #

min :: WksProto -> WksProto -> WksProto #