Go to main content

Configuring and Managing Network Components in Oracle® Solaris 11.4

Exit Print View

Updated: December 2019

Monitoring IP Interfaces and Addresses

    The ipadm command has several show* subcommands to monitor IP interfaces:

  • show-if displays interface information.

  • show-addr provides IP address information.

  • show-ifprop shows information about interface properties.

  • show-addrprop lists information about IP address properties.

See the ipadm(8) man page.

Obtaining General Information About IP Interfaces

The ipadm command provides a comprehensive picture of the system's interfaces. Without accompanying subcommands, ipadm displays default information about all of the system's IP interfaces:

$ ipadm
lo0         loopback   ok          --  --
  lo0/v4    static     ok          --
  lo0/v6    static     ok          --  ::1/128
net0        ip         ok          --   --
  net0/v4   dhcp       ok          --
  net0/v6   addrconf   ok          --  2001:db8:214:4fff:fef9:b1a9/32
  net0/v6   addrconf   ok          --  2001:db8:414:60bb:214:4fff:fef9:b1a9/32
  ipmp0     ipmp       degraded    --   --
  ipmp0/v6  static     ok          --  2001:db8:1:2::4c08/128
  net1      ip         failed   ipmp0  -- 
  net1/v6   addrconf   ok          --  2001:db8:124:4fff:fe58:1831/32  
  net2      ip         ok       ipmp0  --  
  net2/v6   addrconf   ok          --  2001:db8:214:4fff:fe58:1832/10
  iptun0    ip         ok          --  --  
  iptun0/v4  static    ok          -->
  iptun0/v6  static    ok          --  2001:db8:10:5->2001:db8:223:75
  iptun0/v6a static    ok          --  2001:db8:1a0:7::10:5->2001:db8:7a82:64::223:75

    The output shows the following information:

  • IP interfaces and their associated address objects. The address objects are indented.

  • Class of each interface and the types of address of their respective address objects.

  • State of each interface and their address objects. An interface can be either a stand-alone or an underlying interface of another type of interface configuration. Configurations that have underlying interfaces are identified in the UNDER column. In the example, ipmp0 is created over net1 and net2. Note, too, that because net1 has a failed status, then ipmp0's state is also degraded.

  • Actual addresses of their respective address objects.

    A pair of addresses in an address object indicates a tunnel configuration.

Obtaining Information About IP Interfaces

To display information about IP interfaces, use the ipadm show-if interface command. If you do not specify an interface, the information covers all of the interfaces on the system.

$ ipadm show-if
lo0          loopback     ok        yes        --
net0         ip           ok        yes        --
net1         ip           ok        yes        --
tun0         ip           ok        yes        --

    The output displays some of the following information:

  • Class of each interface, which can be ip, ipmp, vni, or loopback.

  • State of each interface, which can be ok, offline, failed, down, or disabled.

    failed applies to an IPMP group that can no longer host traffic because the underlying interfaces have failed. disabled refers to the IP interface that is unplumbed by using the ipadm disable-if command.

  • The OVER column applies to IPMP groups. It identifies the IPMP group that uses the listed IP interfaces.

Obtaining Information About IP Interface Properties

Use the ipadm show-ifprop interface command to obtain information about the properties of IP interfaces. If you do not specify a property or an interface, then information about all the properties of all the IP interfaces on the system is displayed.

$ ipadm show-ifprop -p mtu net1
net1    mtu       ipv4   rw    1500      --         1500     68-1500
net1    mtu       ipv6   rw    1500      --         1500     1280-1500

The following list describes some of the information that is displayed:

  • The interface's property, its current value, and default value if not manually modified.

  • If the property requires numeric values, the range of values is provided.

  • Property permissions which would indicate if the property can be customized or not.

  • The protocol to which the property definition applies, either IPv4 or IPv6.

Note -  If any field value is unknown, such as when an interface does not support the property whose information is being requested, the value is displayed as a question mark (?).

Obtaining Information About IP Addresses

For information about IP addresses, use the ipadm show-addr interface command. If you do not specify an interface, then information about all of the IP addresses that are on the system is displayed.

$ ipadm show-addr
ADDROBJ          TYPE       STATE     ADDR
lo0/v4           static     ok
net0/v4          static     ok
tun0/v4          static     ok>

If you specify an interface with the command and the interface has multiple addresses, the following type of information is displayed:

$ ipadm show-addr net0
ADDROBJ          TYPE       STATE     ADDR
net0/v4          static     ok
net0/v4a         static     ok
net0/v4bc        static     ok

Note that if the address object pertains to a tunnel, then both the local and remote addresses are displayed in the output. See Chapter 5, Administering IP Tunnels in Administering TCP/IP Networks, IPMP, and IP Tunnels in Oracle Solaris 11.4.

An address object that is displayed as interface/? indicates that the address was configured on the interface by an application that did not use libipadm APIs. Such applications are not under the control of the ipadm command.

Obtaining Information About IP Address Properties

For information about IP address properties, use the ipadm show-addrprop addrobj command. If you omit addrobj, information about is displayed. To list a single property for all of the IP addresses, specify just that property.

$ ipadm show-addrprop net1/v4
net1/v4   broadcast    r-  --   --
net1/v4   deprecated   rw     off             --          off              on,off
net1/v4   prefixlen    rw     24              24          24               1-30,32
net1/v4   private      rw     off             --          off              on,off
net1/v4   transmit     rw     on              --          on               on,off
net1/v4   zone         rw     global          --          global           --

Aside from the properties and their respective, permissions, current and default values, the command also displays persistent values. These values are reapplied whenever the system is booted.