# salt.modules.network

Module for gathering and managing network information

`salt.modules.network.` `active_tcp`()

  Return a dict containing information on all of the running TCP connections

  CLI Example:

      salt '*' network.active_tcp

`salt.modules.network.` `arp`()

  Return the arp table from the minion

  CLI Example:

      salt '*' network.arp

`salt.modules.network.` `dig`(host)

  Performs a DNS lookup with dig

  CLI Example:

      salt '*' network.dig archlinux.org

`salt.modules.network.` `hw_addr`(iface)

  Return the hardware address (a.k.a. MAC address) for a given interface

  CLI Example:

      salt '*' network.hw_addr eth0

`salt.modules.network.` `hwaddr`(iface)

  Return the hardware address (a.k.a. MAC address) for a given interface

  CLI Example:

      salt '*' network.hw_addr eth0

`salt.modules.network.` `in_subnet`(cidr)

  Returns True if host is within specified subnet, otherwise False.

  CLI Example:

      salt '*' network.in_subnet 10.0.0.0/16

`salt.modules.network.` `interfaces`()

  Return a dictionary of information about all the interfaces on the minion

  CLI Example:

      salt '*' network.interfaces

`salt.modules.network.` `ip_addrs`(interface=None, include_loopback=False)

  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

`salt.modules.network.` `ip_addrs6`(interface=None, include_loopback=False)

  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

`salt.modules.network.` `ipaddrs`(interface=None, include_loopback=False)

  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

`salt.modules.network.` `ipaddrs6`(interface=None, include_loopback=False)

  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

`salt.modules.network.` `netstat`()

  Return information on open ports and states

  CLI Example:

      salt '*' network.netstat

`salt.modules.network.` `ping`(host)

  Performs a ping to a host

  CLI Example:

      salt '*' network.ping archlinux.org

`salt.modules.network.` `subnets`()

  Returns a list of subnets to which the host belongs

  CLI Example:

      salt '*' network.subnets

`salt.modules.network.` `traceroute`(host)

  Performs a traceroute to a 3rd party host

  CLI Example:

      salt '*' network.traceroute archlinux.org

Current Salt release: 0.17.1

#### Previous topic

salt.modules.netbsdservice

#### Next topic

salt.modules.nfs3

### Quick search

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

### Upcoming SaltStack Events

My conferences on Lanyrd