isc::dns::RRType Class Reference

The RRType class encapsulates DNS resource record types. More...

#include <rrtype.h>

Public Member Functions
Constructors and Destructor
	RRType (uint16_t typecode)
	Constructor from an integer type code. More...
	RRType (const std::string &typestr)
	Constructor from a string. More...
	RRType (isc::util::InputBuffer &buffer)
	Constructor from wire-format data. More...
Converter methods
We use the default copy constructor intentionally. We use the default copy assignment operator intentionally.
const std::string	toText () const
	Convert the RRType to a string. More...
void	toWire (AbstractMessageRenderer &renderer) const
	Render the RRType in the wire format. More...
void	toWire (isc::util::OutputBuffer &buffer) const
	Render the RRType in the wire format. More...
Getter Methods
uint16_t	getCode () const
	Returns the RR type code as a 16-bit unsigned integer. More...
Comparison methods
bool	equals (const RRType &other) const
	Return true iff two RRTypes are equal. More...
bool	operator== (const RRType &other) const
	Same as equals(). More...
bool	nequals (const RRType &other) const
	Return true iff two RRTypes are not equal. More...
bool	operator!= (const RRType &other) const
	Same as nequals(). More...
bool	operator< (const RRType &other) const
	Less-than comparison for RRType against other. More...

Static Public Member Functions
static const RRType &	A ()
static const RRType &	A6 ()
static const RRType &	AAAA ()
static const RRType &	AFSDB ()
static const RRType &	ANY ()
static const RRType &	APL ()
static const RRType &	AXFR ()
static const RRType &	CAA ()
static const RRType &	CERT ()
static const RRType &	CNAME ()
static const RRType &	DHCID ()
static const RRType &	DLV ()
static const RRType &	DNAME ()
static const RRType &	DNSKEY ()
static const RRType &	DS ()
static const RRType &	GPOS ()
static const RRType &	HINFO ()
static const RRType &	HIP ()
static const RRType &	IPSECKEY ()
static const RRType &	ISDN ()
static const RRType &	IXFR ()
static const RRType &	KEY ()
static const RRType &	KX ()
static const RRType &	L32 ()
static const RRType &	L64 ()
static const RRType &	LOC ()
static const RRType &	LP ()
static const RRType &	MAILA ()
static const RRType &	MAILB ()
static const RRType &	MB ()
static const RRType &	MD ()
static const RRType &	MF ()
static const RRType &	MG ()
static const RRType &	MINFO ()
static const RRType &	MR ()
static const RRType &	MX ()
static const RRType &	NAPTR ()
static const RRType &	NID ()
static const RRType &	NS ()
static const RRType &	NSAP ()
static const RRType &	NSAP_PTR ()
static const RRType &	NSEC ()
static const RRType &	NSEC3 ()
static const RRType &	NSEC3PARAM ()
static const RRType &	Null ()
static const RRType &	NXT ()
static const RRType &	OPT ()
static const RRType &	PTR ()
static const RRType &	PX ()
static const RRType &	RP ()
static const RRType &	RRSIG ()
static const RRType &	RT ()
static const RRType &	SIG ()
static const RRType &	SOA ()
static const RRType &	SPF ()
static const RRType &	SRV ()
static const RRType &	SSHFP ()
static const RRType &	TKEY ()
static const RRType &	TLSA ()
static const RRType &	TSIG ()
static const RRType &	TXT ()
static const RRType &	UNSPEC ()
static const RRType &	URI ()
static const RRType &	WKS ()
static const RRType &	X25 ()

Detailed Description

The RRType class encapsulates DNS resource record types.

This class manages the 16-bit integer type codes in quite a straightforward way. The only non trivial task is to handle textual representations of RR types, such as "A", "AAAA", or "TYPE65534".

This class consults a helper RRParamRegistry class, which is a registry of RR related parameters and has the singleton object. This registry provides a mapping between RR type codes and their "well-known" textual representations. Parameters of RR types defined by DNS protocol standards are automatically registered at initialization time and are ensured to be always available for applications unless the application explicitly modifies the registry.

For convenience, this class defines constant class objects corresponding to standard RR types. These are generally referred to as the form of RRType::{type-text}(). For example, RRType::NS() is an RRType object corresponding to the NS resource record (type code 2). Note that these constants are used through a "proxy" function. This is because they may be used to initialize another non-local (e.g. global or namespace-scope) static object as follows:

namespace foo {
const RRType default_type = RRType::A();
} 

In order to ensure that the constant RRType object has been initialized before the initialization for default_type, we need help from the proxy function.

In the current implementation, the initialization of the well-known static objects is not thread safe. The same consideration as the RRParamRegistry class applies. We may extend the implementation so that the initialization is ensured to be thread safe in a future version.

Note to developers: since it's expected that some of these constant RRType objects are frequently used in a performance sensitive path, we define these proxy functions as inline. This makes sense only when the corresponding static objects are defined only once even if they used in different source files. Sufficiently modern compilers should meet this assumption, but if we encounter memory bloat due to this problem with particular compilers we need to revisit the design or think about workaround.

Definition at line 106 of file rrtype.h.

Constructor & Destructor Documentation

isc::dns::RRType::RRType ( uint16_t  typecode )

inlineexplicit

Constructor from an integer type code.

This constructor never throws an exception.

Parameters

typecode

An 16-bit integer code corresponding to the RRType.

Definition at line 117 of file rrtype.h.

isc::dns::RRType::RRType ( const std::string &  typestr )

explicit

Constructor from a string.

A valid string is one of "well-known" textual type representations such as "A", "AAAA", or "NS", or in the standard format for "unknown" RR types as defined in RFC3597, i.e., "TYPEnnnn".

More precisely, the "well-known" representations are the ones stored in the RRParamRegistry registry (see the class description).

As for the format of "TYPEnnnn", "nnnn" must represent a valid 16-bit unsigned integer, which may contain leading 0's as long as it consists of at most 5 characters (inclusive). For example, "TYPE1" and "TYPE001" are valid and represent the same RR type, but "TYPE65536" and "TYPE000001" are invalid. A "TYPEnnnn" representation is valid even if the corresponding type code is registered in the RRParamRegistry object. For example, both "A" and "TYPE1" are valid and represent the same RR type.

All of these representations are case insensitive; "NS" and "ns", and "TYPE1" and "type1" are all valid and represent the same RR types, respectively.

If the given string is not recognized as a valid representation of an RR type, an exception of class InvalidRRType will be thrown.

Parameters

typestr

A string representation of the RRType

Definition at line 28 of file rrtype.cc.

References isc_throw.

isc::dns::RRType::RRType ( isc::util::InputBuffer &  buffer )

explicit

Constructor from wire-format data.

The buffer parameter normally stores a complete DNS message containing the RRType to be constructed. The current read position of the buffer points to the head of the type.

If the given data does not large enough to contain a 16-bit integer, an exception of class IncompleteRRType will be thrown.

Parameters

buffer

A buffer storing the wire format data.

Definition at line 37 of file rrtype.cc.

References isc::util::InputBuffer::getLength(), isc::util::InputBuffer::getPosition(), isc_throw, and isc::util::InputBuffer::readUint16().

Here is the call graph for this function:

Member Function Documentation

const RRType & isc::dns::RRType::A ( )

inlinestatic

Definition at line 341 of file rrtype.h.

Referenced by isc::d2::NameRemoveTransaction::buildRemoveFwdRRsRequest(), and isc::d2::NameChangeTransaction::getAddressRRType().

const RRType & isc::dns::RRType::A6 ( )

inlinestatic

Definition at line 569 of file rrtype.h.

const RRType & isc::dns::RRType::AAAA ( )

inlinestatic

Definition at line 497 of file rrtype.h.

Referenced by isc::d2::NameRemoveTransaction::buildRemoveFwdRRsRequest(), and isc::d2::NameChangeTransaction::getAddressRRType().

const RRType & isc::dns::RRType::AFSDB ( )

inlinestatic

Definition at line 347 of file rrtype.h.

const RRType & isc::dns::RRType::ANY ( )

inlinestatic

Definition at line 527 of file rrtype.h.

Referenced by isc::d2::NameAddTransaction::buildAddFwdAddressRequest(), isc::d2::NameRemoveTransaction::buildRemoveFwdRRsRequest(), isc::d2::NameRemoveTransaction::buildRemoveRevPtrsRequest(), and isc::d2::NameAddTransaction::buildReplaceFwdAddressRequest().

const RRType & isc::dns::RRType::APL ( )

inlinestatic

Definition at line 665 of file rrtype.h.

const RRType & isc::dns::RRType::AXFR ( )

inlinestatic

Definition at line 521 of file rrtype.h.

const RRType & isc::dns::RRType::CAA ( )

inlinestatic

Definition at line 353 of file rrtype.h.

const RRType & isc::dns::RRType::CERT ( )

inlinestatic

Definition at line 659 of file rrtype.h.

const RRType & isc::dns::RRType::CNAME ( )

inlinestatic

Definition at line 359 of file rrtype.h.

const RRType & isc::dns::RRType::DHCID ( )

inlinestatic

Definition at line 503 of file rrtype.h.

Referenced by isc::d2::NameAddTransaction::buildAddFwdAddressRequest(), isc::d2::NameRemoveTransaction::buildRemoveFwdAddressRequest(), isc::d2::SimpleRemoveTransaction::buildRemoveFwdRRsRequest(), isc::d2::NameRemoveTransaction::buildRemoveFwdRRsRequest(), isc::d2::SimpleRemoveTransaction::buildRemoveRevPtrsRequest(), isc::d2::SimpleAddTransaction::buildReplaceFwdAddressRequest(), isc::d2::NameAddTransaction::buildReplaceFwdAddressRequest(), isc::d2::SimpleAddTransaction::buildReplaceRevPtrsRequest(), and isc::d2::NameAddTransaction::buildReplaceRevPtrsRequest().

const RRType & isc::dns::RRType::DLV ( )

inlinestatic

Definition at line 365 of file rrtype.h.

const RRType & isc::dns::RRType::DNAME ( )

inlinestatic

Definition at line 371 of file rrtype.h.

const RRType & isc::dns::RRType::DNSKEY ( )

inlinestatic

Definition at line 377 of file rrtype.h.

const RRType & isc::dns::RRType::DS ( )

inlinestatic

Definition at line 383 of file rrtype.h.

bool isc::dns::RRType::equals ( const RRType &  other ) const

inline

Return true iff two RRTypes are equal.

Two RRTypes are equal iff their type codes are equal.

This method never throws an exception.

Parameters

other

the RRType object to compare against.

Returns

true if the two RRTypes are equal; otherwise false.

Definition at line 226 of file rrtype.h.

Referenced by operator==().

uint16_t isc::dns::RRType::getCode ( ) const

inline

Returns the RR type code as a 16-bit unsigned integer.

This method never throws an exception.

Returns

An 16-bit integer code corresponding to the RRType.

Definition at line 211 of file rrtype.h.

const RRType & isc::dns::RRType::GPOS ( )

inlinestatic

Definition at line 641 of file rrtype.h.

const RRType & isc::dns::RRType::HINFO ( )

inlinestatic

Definition at line 389 of file rrtype.h.

const RRType & isc::dns::RRType::HIP ( )

inlinestatic

Definition at line 677 of file rrtype.h.

const RRType & isc::dns::RRType::IPSECKEY ( )

inlinestatic

Definition at line 671 of file rrtype.h.

const RRType & isc::dns::RRType::ISDN ( )

inlinestatic

Definition at line 623 of file rrtype.h.

const RRType & isc::dns::RRType::IXFR ( )

inlinestatic

Definition at line 515 of file rrtype.h.

const RRType & isc::dns::RRType::KEY ( )

inlinestatic

Definition at line 629 of file rrtype.h.

const RRType & isc::dns::RRType::KX ( )

inlinestatic

Definition at line 653 of file rrtype.h.

const RRType & isc::dns::RRType::L32 ( )

inlinestatic

Definition at line 695 of file rrtype.h.

const RRType & isc::dns::RRType::L64 ( )

inlinestatic

Definition at line 701 of file rrtype.h.

const RRType & isc::dns::RRType::LOC ( )

inlinestatic

Definition at line 647 of file rrtype.h.

const RRType & isc::dns::RRType::LP ( )

inlinestatic

Definition at line 707 of file rrtype.h.

const RRType & isc::dns::RRType::MAILA ( )

inlinestatic

Definition at line 575 of file rrtype.h.

const RRType & isc::dns::RRType::MAILB ( )

inlinestatic

Definition at line 713 of file rrtype.h.

const RRType & isc::dns::RRType::MB ( )

inlinestatic

Definition at line 545 of file rrtype.h.

const RRType & isc::dns::RRType::MD ( )

inlinestatic

Definition at line 533 of file rrtype.h.

const RRType & isc::dns::RRType::MF ( )

inlinestatic

Definition at line 539 of file rrtype.h.

const RRType & isc::dns::RRType::MG ( )

inlinestatic

Definition at line 551 of file rrtype.h.

const RRType & isc::dns::RRType::MINFO ( )

inlinestatic

Definition at line 395 of file rrtype.h.

const RRType & isc::dns::RRType::MR ( )

inlinestatic

Definition at line 557 of file rrtype.h.

const RRType & isc::dns::RRType::MX ( )

inlinestatic

Definition at line 401 of file rrtype.h.

const RRType & isc::dns::RRType::NAPTR ( )

inlinestatic

Definition at line 407 of file rrtype.h.

bool isc::dns::RRType::nequals ( const RRType &  other ) const

inline

Return true iff two RRTypes are not equal.

This method never throws an exception.

Parameters

other

the RRType object to compare against.

Returns

true if the two RRTypes are not equal; otherwise false.

Definition at line 237 of file rrtype.h.

Referenced by operator!=().

const RRType & isc::dns::RRType::NID ( )

inlinestatic

Definition at line 689 of file rrtype.h.

const RRType & isc::dns::RRType::NS ( )

inlinestatic

Definition at line 413 of file rrtype.h.

const RRType & isc::dns::RRType::NSAP ( )

inlinestatic

Definition at line 605 of file rrtype.h.

const RRType & isc::dns::RRType::NSAP_PTR ( )

inlinestatic

Definition at line 611 of file rrtype.h.

const RRType & isc::dns::RRType::NSEC ( )

inlinestatic

Definition at line 431 of file rrtype.h.

const RRType & isc::dns::RRType::NSEC3 ( )

inlinestatic

Definition at line 419 of file rrtype.h.

const RRType & isc::dns::RRType::NSEC3PARAM ( )

inlinestatic

Definition at line 425 of file rrtype.h.

const RRType & isc::dns::RRType::Null ( )

inlinestatic

Definition at line 581 of file rrtype.h.

const RRType & isc::dns::RRType::NXT ( )

inlinestatic

Definition at line 563 of file rrtype.h.

bool isc::dns::RRType::operator!= ( const RRType &  other ) const

inline

Same as nequals().

Definition at line 240 of file rrtype.h.

References nequals().

Here is the call graph for this function:

bool isc::dns::RRType::operator< ( const RRType &  other ) const

inline

Less-than comparison for RRType against other.

We define the less-than relationship based on their type codes; one RRType is less than the other iff the code of the former is less than that of the other as unsigned integers. The relationship is meaningless in terms of DNS protocol; the only reason we define this method is that RRType objects can be stored in STL containers without requiring user-defined less-than relationship. We therefore don't define other comparison operators.

This method never throws an exception.

Parameters

other

the RRType object to compare against.

Returns

true if this RRType is less than the other; otherwise false.

Definition at line 257 of file rrtype.h.

bool isc::dns::RRType::operator== ( const RRType &  other ) const

inline

Same as equals().

Definition at line 229 of file rrtype.h.

References equals().

Here is the call graph for this function:

const RRType & isc::dns::RRType::OPT ( )

inlinestatic

Definition at line 437 of file rrtype.h.

Referenced by isc::dns::EDNS::EDNS(), and isc::dns::MessageImpl::parseSection().

const RRType & isc::dns::RRType::PTR ( )

inlinestatic

Definition at line 443 of file rrtype.h.

Referenced by isc::d2::SimpleRemoveTransaction::buildRemoveRevPtrsRequest(), isc::d2::NameRemoveTransaction::buildRemoveRevPtrsRequest(), isc::d2::SimpleAddTransaction::buildReplaceRevPtrsRequest(), and isc::d2::NameAddTransaction::buildReplaceRevPtrsRequest().

const RRType & isc::dns::RRType::PX ( )

inlinestatic

Definition at line 635 of file rrtype.h.

const RRType & isc::dns::RRType::RP ( )

inlinestatic

Definition at line 449 of file rrtype.h.

const RRType & isc::dns::RRType::RRSIG ( )

inlinestatic

Definition at line 455 of file rrtype.h.

Referenced by isc::dns::RRset::addRRsig().

const RRType & isc::dns::RRType::RT ( )

inlinestatic

Definition at line 599 of file rrtype.h.

const RRType & isc::dns::RRType::SIG ( )

inlinestatic

Definition at line 617 of file rrtype.h.

const RRType & isc::dns::RRType::SOA ( )

inlinestatic

Definition at line 461 of file rrtype.h.

Referenced by isc::d2::D2UpdateMessage::setZone().

const RRType & isc::dns::RRType::SPF ( )

inlinestatic

Definition at line 467 of file rrtype.h.

const RRType & isc::dns::RRType::SRV ( )

inlinestatic

Definition at line 509 of file rrtype.h.

const RRType & isc::dns::RRType::SSHFP ( )

inlinestatic

Definition at line 473 of file rrtype.h.

const RRType & isc::dns::RRType::TKEY ( )

inlinestatic

Definition at line 479 of file rrtype.h.

const RRType & isc::dns::RRType::TLSA ( )

inlinestatic

Definition at line 485 of file rrtype.h.

const string isc::dns::RRType::toText

(

)

const

Convert the RRType to a string.

If a "well known" textual representation for the type code is registered in the RR parameter registry (see the class description), that will be used as the return value of this method. Otherwise, this method creates a new string for an "unknown" RR type in the format defined in RFC3597, i.e., "TYPEnnnn", and returns it.

If resource allocation for the string fails, a corresponding standard exception will be thrown.

Returns

A string representation of the RRType.

Definition at line 45 of file rrtype.cc.

Referenced by isc::dns::operator<<(), isc::dns::Question::toText(), and isc::dns::TSIGRecord::toText().

void isc::dns::RRType::toWire

(

AbstractMessageRenderer &

renderer

)

const

Render the RRType in the wire format.

This method renders the type code in network byte order via renderer, which encapsulates output buffer and other rendering contexts.

If resource allocation in rendering process fails, a corresponding standard exception will be thrown.

Parameters

renderer

DNS message rendering context that encapsulates the output buffer in which the RRType is to be stored.

Definition at line 55 of file rrtype.cc.

References isc::dns::AbstractMessageRenderer::writeUint16().

Referenced by isc::dns::BasicRRsetImpl::toWire(), and isc::dns::Question::toWire().

Here is the call graph for this function:

void isc::dns::RRType::toWire

(

isc::util::OutputBuffer &

buffer

)

const

Render the RRType in the wire format.

This method renders the type code in network byte order into the buffer.

If resource allocation in rendering process fails, a corresponding standard exception will be thrown.

Parameters

buffer

An output buffer to store the wire data.

Definition at line 50 of file rrtype.cc.

References isc::util::OutputBuffer::writeUint16().

Here is the call graph for this function:

const RRType & isc::dns::RRType::TSIG ( )

inlinestatic

Definition at line 335 of file rrtype.h.

Referenced by isc::dns::MessageImpl::parseSection(), and isc::dns::TSIGRecord::toText().

const RRType & isc::dns::RRType::TXT ( )

inlinestatic

Definition at line 491 of file rrtype.h.

const RRType & isc::dns::RRType::UNSPEC ( )

inlinestatic

Definition at line 683 of file rrtype.h.

const RRType & isc::dns::RRType::URI ( )

inlinestatic

Definition at line 719 of file rrtype.h.

const RRType & isc::dns::RRType::WKS ( )

inlinestatic

Definition at line 587 of file rrtype.h.

const RRType & isc::dns::RRType::X25 ( )

inlinestatic

Definition at line 593 of file rrtype.h.

---

The documentation for this class was generated from the following files:

• rrtype.h
• rrtype.cc