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.
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 NAME CLASS/TYPE STATE UNDER ADDR lo0 loopback ok -- -- lo0/v4 static ok -- 127.0.0.1/8 lo0/v6 static ok -- ::1/128 net0 ip ok -- -- net0/v4 dhcp ok -- 203.0.113.233/23 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 -- 198.51.110.5->198.51.110.75 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.
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 IFNAME CLASS STATE ACTIVE OVER 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.
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 IFNAME PROPERTY PROTO PERM CURRENT PERSISTENT DEFAULT POSSIBLE 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.
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 127.0.0.1/8 net0/v4 static ok 198.51.100.3/24 tun0/v4 static ok 203.0.113.1-->203.0.113.2
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 198.51.100.3/24 net0/v4a static ok 192.0.2.1/24 net0/v4bc static ok 203.0.113.1
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.
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 ADDROBJ PROPERTY PERM CURRENT PERSISTENT DEFAULT POSSIBLE net1/v4 broadcast r- 198.51.100.255 -- 198.51.100.255 -- 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.