Module for gathering and managing network information
Performs a DNS lookup with dig
Note: dig must be installed on the Windows minion
CLI Example:
salt '*' network.dig archlinux.org
Return the hardware address (a.k.a. MAC address) for a given interface
CLI Example:
salt '*' network.hw_addr 'Wireless Connection #1'
Return the hardware address (a.k.a. MAC address) for a given interface
CLI Example:
salt '*' network.hw_addr 'Wireless Connection #1'
Returns True if host is within specified subnet, otherwise False
CLI Example:
salt '*' network.in_subnet 10.0.0.0/16
Return a dictionary of information about all the interfaces on the minion
CLI Example:
salt '*' network.interfaces
Returns a list of IPv4 addresses assigned to the host. 127.0.0.1 is ignored, unless 'include_loopback=True' is indicated. If 'interface' is provided, then only IP addresses from that interface will be returned.
CLI Example:
salt '*' network.ip_addrs
Returns a list of IPv6 addresses assigned to the host. ::1 is ignored, unless 'include_loopback=True' is indicated. If 'interface' is provided, then only IP addresses from that interface will be returned.
CLI Example:
salt '*' network.ip_addrs6
Returns a list of IPv4 addresses assigned to the host. 127.0.0.1 is ignored, unless 'include_loopback=True' is indicated. If 'interface' is provided, then only IP addresses from that interface will be returned.
CLI Example:
salt '*' network.ip_addrs
Returns a list of IPv6 addresses assigned to the host. ::1 is ignored, unless 'include_loopback=True' is indicated. If 'interface' is provided, then only IP addresses from that interface will be returned.
CLI Example:
salt '*' network.ip_addrs6
Return information on open ports and states
CLI Example:
salt '*' network.netstat
Query DNS for information about a domain or ip address
CLI Example:
salt '*' network.nslookup archlinux.org
Performs a ping to a host
CLI Example:
salt '*' network.ping archlinux.org
Returns a list of subnets to which the host belongs
CLI Example:
salt '*' network.subnets
Performs a traceroute to a 3rd party host
CLI Example:
salt '*' network.traceroute archlinux.org
Current Salt release: 2014.1.6
Docs for previous releases on salt.rtfd.org.