0
0
Fork 0
mirror of https://github.com/matrix-construct/construct synced 2024-11-30 02:32:43 +01:00
construct/include/ircd/rfc1035.h
2018-01-14 20:45:30 -08:00

125 lines
4.5 KiB
C++

// Copyright (C) Matrix Construct Developers, Authors & Contributors
// Copyright (C) 2016-2018 Jason Volk
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice is present in all copies.
//
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
// WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
// DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
// INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
#pragma once
#define HAVE_IRCD_RFC1035_H
/// RFC 1035 (Nov. 1987)
///
namespace ircd::rfc1035
{
IRCD_EXCEPTION(ircd::error, error)
struct header;
struct question;
struct answer;
enum class op :uint8_t;
extern const std::array<string_view, 25> rcode;
extern const std::unordered_map<string_view, uint16_t> qtype;
mutable_buffer make_query(const mutable_buffer &, const header &, const vector_view<const question> &);
mutable_buffer make_query(const mutable_buffer &, const vector_view<const question> &);
mutable_buffer make_query(const mutable_buffer &, const question &);
}
/// Helper class to construct a question. An object is constructed with a
/// fully qualified domain string and the query type (qtype). At the
/// appropriate time we will call operator() which prints a properly binary-
/// formatted question for the question section in a DNS query; generally the
/// user does not need to do this.
///
/// Note that each part of the fqdn cannot be longer than 63 characters. The
/// supplied buffer must be large enough to hold the output, which is about
/// the length of the fqdn + 6 bytes. The qtype can be specified as a string
/// i.e "A" or "PTR" and it will be translated into the protocol number for
/// you in the constructor.
///
struct ircd::rfc1035::question
{
string_view fqdn;
uint16_t qtype;
uint16_t qclass {0x01};
/// Composes the question into buffer, returns used portion
mutable_buffer operator()(const mutable_buffer &) const;
/// Trivial constructor; supply fully qualified domain name and query type
question(const string_view &fqdn, const uint16_t &qtype = 0x01) // "A"
:fqdn{fqdn}
,qtype{qtype}
{}
/// Supply fully qualified domain name and name of query type i.e "A"
question(const string_view &fqdn, const string_view &qtype)
:fqdn{fqdn}
,qtype{rfc1035::qtype.at(qtype)}
{}
};
struct ircd::rfc1035::answer
{
uint16_t qtype;
uint16_t qclass;
uint32_t ttl;
uint16_t rdlength;
const_raw_buffer rdata;
char name[256];
answer(const const_raw_buffer &);
};
/// Direct representation of the DNS header. This is laid out for
/// little-endian platforms only. The uint16_t's are still big-endian and
/// must be bswap()'ed.
///
struct ircd::rfc1035::header
{
uint16_t id; ///< query identification number
uint8_t rd:1; ///< 0 = recursion not desired; 1 = desired
uint8_t tc:1; ///< 0 = not-truncated; 1 = 512 bytes of reply only
uint8_t aa:1; ///< 0 = non-authoritative; 1 = authoritative
uint8_t opcode:4; ///< purpose of message
uint8_t qr:1; ///< 0 = query; 1 = respnse
uint8_t rcode:4; ///< response code
uint8_t cd:1; ///< checking disabled by resolver
uint8_t ad:1; ///< authentic data from named
uint8_t unused:1; ///< unused bits (MBZ as of 4.9.3a3)
uint8_t ra:1; ///< 1 = recursion available
uint16_t qdcount; ///< number of question entries
uint16_t ancount; ///< number of answer entries
uint16_t nscount; ///< number of authority entries
uint16_t arcount; ///< number of resource entries
}
__attribute__((packed));
static_assert
(
sizeof(ircd::rfc1035::header) == 12,
"The RFC1035 header is not the right size in this environment"
);
enum class ircd::rfc1035::op
:uint8_t
{
QUERY = 0, ///< Query [RFC 1035]
IQUERY = 1, ///< Inverse Query [RFC 1035, RFC 3425]
STATUS = 2, ///< Server status request [RFC 1035]
NOTIFY = 4, ///< Notify [RFC 1996]
UPDATE = 5, ///< Update [RFC 2136]
};