This document has been placed in the public domain by Sam Trenholme

# DNS record types

This is a list of some DNS record types which MaraDNS supports.

A
  A, or address, records describe the IP that a given DNS node has.

  MaraDNS uses the A character to signify an A record. This has one data-dependent field: The ip for the node in question, in dotted decimal (e.g. 192.168.42.55) format.

MX
  MX, or mail exchange, records describe the machines to contact in order to send mail to a given DNS node.

  MaraDNS uses the @ character to signify an MX record. This has two data-dependent fields: The preference for the mail exchanger (lower preferences get higher priority), and the name of the DNS node to deliver mail to.

NS
  NS, or name server, records are used to tell other DNS servers which DNS servers to contact in order to find out information for a given DNS node. For example, a NS record for example.com tells other DNS servers which DNS servers to contact in order to obtain information for the example.com domain. Because of the way MaraDNS is set up, all of the NS records for a given DNS zone need to be placed immediately after the SOA record.

  MaraDNS uses the N character to signify an NS record. This has one data-dependent field: The name of the DNS node which this NS record points to.

SOA
  SOA, or "start of authority", records are used by other DNS servers, and, unfortunatly, are therefore required by MaraDNS. Each zone file must start with an SOA record.

  MaraDNS uses the S character to signify an SOA record. A SOA record has seven data-dependent fields, as follows:

  - The first field needs to be the name of the DNS zone in question
  - The second field should ideally be an email address. Just use nobody@example.com
  - The third field, which is numeric, is called the "serial" for the zone in question. In the case of MaraDNS being a "primary zone server" for another DNS server, this number needs to be incremented every time the zone file is changed. Otherwise, just give this a value of 1.
  - The fourth field, also numeric, is the "refresh" of a zone. Just make this 7200 (two hours).
  - The fifth field is the "retry" of a zone. Just make this 3600 (one hour).
  - The sixth field is the "expire" for a zone. Just make this some really bug number, like 4838400 (eight weeks).
  - The seventh field is the "minimum" for a given zone. Some caching DNS servers use this number to determine how long to remeber that a given DNS node does not exist, and "secondary zone servers" also use this number. It is safe to give this the same value as the TTL for the SOA record (For example, 86400 seconds: one day).
  In most cases, MaraDNS zone files can start with this particular SOA record:

      S%|86400|%|nobody@example.com.|19770616|7200|3600|4838400|1800

TXT
  TXT, or text, records are arbitrary text strings (up to 255 characters long) which can be attached to given DNS nodes. Useful for using DNS to make public notes available, such as "My goodness, someone is actually reading a DNS TXT record".

  MaraDNS uses the T character to signify a TXT record. This has one data-dependent record: The text string in question.

Note that this document does not describe every single record type that MaraDNS support. Please refer to the CSV1 manual page for a more complete reference.