dnsrecord.h

Go to the documentation of this file.

 
#pragma once
 
 
#include <promeki/config.h>
#if PROMEKI_ENABLE_NETWORK
#include <cstdint>
#include <promeki/namespace.h>
#include <promeki/duration.h>
#include <promeki/ipv4address.h>
#include <promeki/ipv6address.h>
#include <promeki/list.h>
#include <promeki/string.h>
#if PROMEKI_ENABLE_MDNS
#include <promeki/mdnstxtrecord.h>
#endif
 
PROMEKI_NAMESPACE_BEGIN
 
struct DnsQuestion {
        String   name;
        uint16_t type             = 0;
        uint16_t klass            = 1;
        bool     unicastResponse  = false;
};
 
class DnsRecord {
        public:
                enum class Type : uint16_t {
                        Unknown = 0,
                        A       = 1,
                        Ns      = 2,
                        Cname   = 5,
                        Soa     = 6,
                        Ptr     = 12,
                        Mx      = 15,
                        Txt     = 16,
                        Aaaa    = 28,
                        Srv     = 33,
                        Naptr   = 35,
                        Opt     = 41,
                        Ds      = 43,
                        Rrsig   = 46,
                        Nsec    = 47,
                        Dnskey  = 48,
                        Tlsa    = 52,
                        Svcb    = 64,
                        Https   = 65,
                        Axfr    = 252,
                        Any     = 255,
                        Caa     = 257,
                };
 
                enum class Section : uint8_t {
                        Question   = 0,
                        Answer     = 1,
                        Authority  = 2,
                        Additional = 3,
                };
 
                static constexpr int64_t DefaultTtlSeconds = 75 * 60;
 
                // ===== Common header fields =====================================
                Type     type        = Type::Unknown;
                Section  section     = Section::Answer;
                uint16_t klass       = 1;   
                String   name;
                Duration ttl;
                bool     cacheFlush  = false;
 
                // ===== Type-specific payload ====================================
                String        ptrTarget;
                String        cnameTarget;
                String        nsTarget;
                uint16_t      srvPriority = 0;
                uint16_t      srvWeight   = 0;
                uint16_t      srvPort     = 0;
                String        srvTarget;
                uint16_t      mxPreference = 0;
                String        mxExchange;
#if PROMEKI_ENABLE_MDNS
                MdnsTxtRecord txt;
#endif
                Ipv4Address   a;
                Ipv6Address   aaaa;
 
                // ===== SOA fields (RFC 1035) ====================================
                String   soaMname;
                String   soaRname;
                uint32_t soaSerial  = 0;
                uint32_t soaRefresh = 0;
                uint32_t soaRetry   = 0;
                uint32_t soaExpire  = 0;
                uint32_t soaMinimum = 0;
 
                // ===== NAPTR fields (RFC 3403) ==================================
                uint16_t naptrOrder      = 0;
                uint16_t naptrPreference = 0;
                String   naptrFlags;
                String   naptrService;
                String   naptrRegexp;
                String   naptrReplacement;
 
                // ===== CAA fields (RFC 8659) ====================================
                uint8_t  caaFlags = 0;
                String   caaTag;
                String   caaValue;
 
                // ===== Catch-all =================================================
                List<uint8_t> rawRdata;
 
                // ===== Convenience helpers ======================================
                bool isGoodbye() const { return ttl == Duration::zero(); }
 
                static DnsRecord makeA(const String &owner, const Ipv4Address &addr,
                                       const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makeAaaa(const String &owner, const Ipv6Address &addr,
                                          const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makePtr(const String &owner, const String &target,
                                         const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makeSrv(const String &owner, const String &target, uint16_t port,
                                         uint16_t priority = 0, uint16_t weight = 0,
                                         const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makeCname(const String &owner, const String &target,
                                           const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makeNs(const String &owner, const String &target,
                                        const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
 
                static DnsRecord makeMx(const String &owner, const String &exchange, uint16_t preference,
                                        const Duration &ttl = Duration::fromSeconds(DefaultTtlSeconds));
};
 
#if PROMEKI_ENABLE_MDNS
using MdnsParsedRecord = DnsRecord;
 
using MdnsParsedQuestion = DnsQuestion;
#endif
 
PROMEKI_NAMESPACE_END
 
#endif // PROMEKI_ENABLE_NETWORK