# salt.modules.dnsutil

Compendium of generic DNS utilities

`salt.modules.dnsutil.` `A`(host, nameserver=None)

  Return the A record for 'host'.

  Always returns a list.

  CLI Example:

      salt ns1 dig.A www.google.com

`salt.modules.dnsutil.` `MX`(domain, resolve=False, nameserver=None)

  Return a list of lists for the MX of `domain`.

  If the 'resolve' argument is True, resolve IPs for the servers.

  It's limited to one IP, because although in practice it's very rarely a round robin, it is an acceptable configuration and pulling just one IP lets the data be similar to the non-resolved version. If you think an MX has multiple IPs, don't use the resolver here, resolve them in a separate step.

  CLI Example:

      salt ns1 dig.MX google.com

`salt.modules.dnsutil.` `NS`(domain, resolve=True, nameserver=None)

  Return a list of IPs of the nameservers for `domain`

  If 'resolve' is False, don't resolve names.

  CLI Example:

      salt ns1 dig.NS google.com

`salt.modules.dnsutil.` `SPF`(domain, record='SPF', nameserver=None)

  Return the allowed IPv4 ranges in the SPF record for `domain`.

  If record is `SPF` and the SPF record is empty, the TXT record will be searched automatically. If you know the domain uses TXT and not SPF, specifying that will save a lookup.

  CLI Example:

      salt ns1 dig.SPF google.com

`salt.modules.dnsutil.` `check_ip`(ip_addr)

  Check that string ip_addr is a valid IP

  CLI Example:

      salt ns1 dig.check_ip 127.0.0.1

`salt.modules.dnsutil.` `hosts_append`(hostsfile='/etc/hosts', ip_addr=None, entries=None)

  Append a single line to the /etc/hosts file.

  CLI Example:

      salt '*' dnsutil.hosts_append /etc/hosts 127.0.0.1 ad1.yuk.co,ad2.yuk.co

`salt.modules.dnsutil.` `hosts_remove`(hostsfile='/etc/hosts', entries=None)

  Remove a host from the /etc/hosts file. If doing so will leave a line containing only an IP address, then the line will be deleted. This function will leave comments and blank lines intact.

  CLI Examples:

      salt '*' dnsutil.hosts_remove /etc/hosts ad1.yuk.co
      salt '*' dnsutil.hosts_remove /etc/hosts ad2.yuk.co,ad1.yuk.co

`salt.modules.dnsutil.` `parse_hosts`(hostsfile='/etc/hosts', hosts=None)

  Parse /etc/hosts file.

  CLI Example:

      salt '*' dnsutil.parse_hosts

`salt.modules.dnsutil.` `parse_zone`(zonefile=None, zone=None)

  Parses a zone file. Can be passed raw zone data on the API level.

  CLI Example:

      salt ns1 dnsutil.parse_zone /var/lib/named/example.com.zone

Current Salt release: 0.17.1

#### Previous topic

salt.modules.dnsmasq

#### Next topic

salt.modules.dockerio

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd