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