<abbr class="glossary" title="Domain Name Server">dnsabbr>-zone-get

an> an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">Requires:an>

able style="width: 80%;" border="1" cellspacing="0" cellpadding="2" align="left"> align="left" valign="middle"> an style="font-family: arial,helvetica,sans-serif; font-size: small;">domainan> align="left" valign="middle">an style="font-family: arial,helvetica,sans-serif; font-size: small;">Zone (domain) name to fetch data froman> able>

 

 

an style="font-family: arial,helvetica,sans-serif; font-size: small;">Returns:an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">Returns list of zone records. an>

an> The format of zone is as follows (one record per line):
an>

an style="font-size: small;"><label> <type> <pri> <target> <ttl> <valid-from> <valid-to> <parameters(s)> an>

 

Wan>here:an>an style="font-family: arial,helvetica,sans-serif; font-size: small;">
an>

able style="height: 181px; width: 542px;" border="1" cellspacing="0" cellpadding="2">

an style="font-family: arial,helvetica,sans-serif; font-size: small;">labelan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">subdomain/redirection label, relative to current zone, or '@' (which means current zone name)an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> typean>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record type (A, AAAA, MX, CNAME, URL, MAILFW, TXT, NAPTR, DYNA, DYNAAAA, SRV, CAA)an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> prian>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">numeric value, meaningful only for types MX, NAPTR and SRV, must be 0 for all other typesan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> targetan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record target/value. Must be quoted if contains spacesan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> ttlan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record TTL (time to live) in secondsan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> valid-froman>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record is not valid before this time (UNIX timestamp) or 0an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> valid-toan>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record is not valid after this time (UNIX timestamp) or 0an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> parameters 
an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">record-specific parameter(s)an>

able>

 

an style="font-family: arial,helvetica,sans-serif; font-size: small;">All values from "name" to "ttl" are mandatory for every record.

<valid-to> and <valid-from> are not implemented yet, so usually are 0, and may be omitted if there are no other parameters required.

<parameters(s)> are record dependent, used in NAPTR, MAILFW, FRAME and URL records.

<ttl> must be at least 60 for all records except NAPTR and SVC, where it can be 0 (meaning: no caching). For MAILFW/URL/FRAME <ttl> is irrelevant and assumed to be 60 seconds (i.e., any change will be
in effect within 60 seconds from zone change).

<pri> preference value for MX records, priority/weight for SRV records and order/preference for NAPTR records. For any other record, the value must be 0.

an> Examples of zone records:an style="font-family: arial,helvetica,sans-serif; font-size: small;">
an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;"> an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">an style="font-family: courier new,courier;">www A 0 127.0.0.1 86400
www AAAA 0 fec0::17 86400
an>
an style="font-family: courier new,courier;"> @ MX 10 mail.example.com. 86400

redirect URL 0 <a class="moz-txt-link-freetext" href="..//">http://joker.coma> 86400
an>
an>

 

Sets redirection from redirect.joker.com to <a href="..//">http://joker.coma> (assuming that current zone is "joker.com").
an style="font-family: arial,helvetica,sans-serif; font-size: small;">
an style="font-family: courier new,courier;"> frame FRAME 0 <a class="moz-txt-link-freetext" href="..//">http://joker.coma> 86400 0 0 "Header: Frame-Forward" "head" "title" "body"
an>
Sets frame-based redirection similar to URL redirection.

For FRAME record, extra parameters are as follows:

an>

  • an style="font-family: arial,helvetica,sans-serif; font-size: small;"> Extra HTTP headers. (newlines may be escaped as \n)an>
  • an style="font-family: arial,helvetica,sans-serif; font-size: small;"> Extra text placed in <head></head> section of generated HTML.an>
  • an style="font-family: arial,helvetica,sans-serif; font-size: small;"> Title text (<title></title>) of generated HTML.an>
  • an style="font-family: arial,helvetica,sans-serif; font-size: small;"> Body text (used for <noframes> section)an>

an style="font-family: arial,helvetica,sans-serif; font-size: small;">
an style="font-family: courier new,courier;"> username MAILFW 0 <a class="moz-txt-link-abbreviated" href="mailto:redirected@example.com">redirected@example.coma> 86400 0 0 1
an>
This MAILFW records makes redirection of mail sent to <a class="moz-txt-link-abbreviated" href="mailto:username@joker.com">username@joker.coma> (assuming that current zone name is "joker.com") to <a class="moz-txt-link-abbreviated" href="mailto:redirected@example.com">redirected@example.coma>, extra parameter ("1") specifies that spam-filtering should be used.

an style="font-family: courier new,courier;"> naptr NAPTR 10/100 replacement 86400 0 0 "flags" "service" "regex"an>

This NAPTR record has order 10 and preference 100. Only one of "replacement" or "regex" may be
specified, if "regex" is specified, "replacement" must be "." (without quotes), if "replacement"
is specified, "regex" must be empty string. Quotes are mandatory for all extra parameters.
For details please consult RFC 2915, or look here: <a class="moz-txt-link-freetext" href="http://de.wikipedia.org/wiki/NAPTR">http://de.wikipedia.org/wiki/NAPTRa>

an style="font-family: courier new,courier;"> _ldap._tcp SRV 10/100 ldap.example.com:389 60an>

This SRV record has priority 10, weight 100, target "ldap.example.com" and port "389" with TTL 60 seconds. Please consult RFC 2782 for details.

an style="font-family: courier new,courier;"> txt TXT 0 "key=value" 86400an>

Quoting of values for TXT records is mandatory.

an>

an style="font-family: 'courier new', courier; font-size: small;">caa   CAA 0   issue "letsencrypt.org" 86400
caa   CAA 0   issuewild "letsencrypt.org" 86400
an>

an style="font-family: 'courier new', courier; font-size: small;">caa   CAA 0   iodef "mailto:certissues@example.com" 86400an>

an style="font-family: 'courier new', courier; font-size: small;"> an>

an style="font-family: arial, helvetica, sans-serif; font-size: small;">For more information about CAA records please check <a title="CAA record" href="https://en.wikipedia.org/wiki/DNS_Certification_Authority_Authorization" target="_blank">Wikipediaa>.an>an style="font-size: 13px;"> an>

 

an style="font-family: arial,helvetica,sans-serif; font-size: small;">an style="font-family: courier new,courier;">www CNAME 0 example.com. 86400an>

Two special record types, DYNA and DYNAAAA, are used in case if DynDNS is active.
They have same meaning as corresponding "A" and "AAAA" records, except that their targets may be updated using Joker DynDNS service.

To enable/disable DynDNS service, and to define username/password used to access it, the record format is as follows:

an style="font-family: courier new,courier;"> $dyndns=yes:username:passwordan>

username/password may not contain spaces or colon (":") characters. If "no" is specified instead of "yes", DynDNS will be turned off (i.e. DYN* entries will have no effect).

In case if there are any errors, zone modification will not be accepted. All errors will be reported for every erroneous line, so if there are more than one, you will be able to see all detected errors.
an>

 

Tags: DMAPI, DNS, modify-zone, Nameservice

Related entries:

You cannot comment on this entry