ltm rule command DNS additional

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



DNS::additional
       Returns, inserts, removes, or clears RRs from the additional section.

SYNOPSIS
       DNS::additional ('clear' | (('insert' | 'remove') RR_OBJECT))?

DESCRIPTION
       This iRules command returns, inserts, removes, or clears RRs from the
       additional section.

       Note: This command functions only in the context of LTM iRules and
       requires the DNS Profile, which is only enabled as part of GTM or the
       DNS Services add-on.

       Syntax

       DNS::additional [[insert|remove rr_obj] | clear]

	    * Returns, inserts, removes, or clears RRs from the additional
	      section. With no arguments, get tcl list of RR objs; with arg,
	      insert/remove RR tcl obj in the additional section or clear all RRs
	      from the additional section.

RETURN VALUE
VALID DURING
       DNS_REQUEST, DNS_RESPONSE

EXAMPLES
	Change the TTL of all answer records and add a glue record

	    when DNS_RESPONSE {
		set rrs [DNS::answer]
		foreach rr $rrs {
		    DNS::ttl $rr 1234
		}
		set new_rr [DNS::rr "bigip3900-30.f5net.com. 88 IN A 1.2.3.4"]
		DNS::additional insert $new_rr
	    }

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-11.1.0 --First introduced the command.



BIG-IP				  2017-01-31			      iRule(1)