Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Administration: Network Interfaces and Network Virtualization Oracle Solaris 11 Information Library |
1. Overview of the Networking Stack
Network Configuration in This Oracle Solaris Release
The Network Stack in Oracle Solaris
Network Devices and Datalink Names
Administration of Other Link Types
3. NWAM Configuration and Administration (Overview)
4. NWAM Profile Configuration (Tasks)
5. NWAM Profile Administration (Tasks)
6. About the NWAM Graphical User Interface
Part II Datalink and Interface Configuration
7. Using Datalink and Interface Configuration Commands on Profiles
8. Datalink Configuration and Administration
9. Configuring an IP Interface
About IP Interface Configuration
IP Interface Configuration (Tasks)
SPARC: How to Ensure That the MAC Address of an Interface Is Unique
How to Configure an IP Interface
How to Set the Property of an IP Address
Setting IP Interface Properties
Administering Protocol Properties
How to Restrict a Port's Access to root User Only
How to Implement Symmetric Routing on Multihomed Hosts
Troubleshooting Interface Configuration
The ipadm command does not work.
IP address cannot be assigned with the ipadm create-addr command.
Comparison Tables: ipadm Command and Other Networking Commands
ifconfig Command Options and ipadm Command Options
ndd Command Options and ipadm Command Options
10. Configuring Wireless Interface Communications on Oracle Solaris
12. Administering Link Aggregations
16. Exchanging Network Connectivity Information With LLDP
Part III Network Virtualization and Resource Management
17. Introducing Network Virtualization and Resource Control (Overview)
18. Planning for Network Virtualization and Resource Control
19. Configuring Virtual Networks (Tasks)
20. Using Link Protection in Virtualized Environments
21. Managing Network Resources
The ipadm command is also the preferred tool for monitor and obtain information about IP interfaces and their properties or parameters. The ipadm subcommands to obtain interface information use the following basic syntax:
ipadm show-* [other-arguments] [interface]
To obtain interface information, use ipadm show-if.
To obtain address information, use ipadm show-addr.
To obtain information about a specific interface property, use ipadm show-ifprop.
To obtain information about a specific address property, use ipadm show-addrprop
This section provides several examples of using the ipadm command to obtain information about the network interfaces. For other types of monitoring tasks that you perform on the network, refer to Chapter 5, Administering a TCP/IP Network, in Oracle Solaris Administration: IP Services.
Note - For an explanation of all the fields in the ipadm show-* commands, refer to the ipadm(1M) man page.
This procedure describes how to display information about an interface's general status, address information, and IP properties.
For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.
# ipadm show-if [interface]
If you do not specify an interface, then the information covers all the interfaces on the system.
The fields in the command output refer to the following:
Refers to the interface whose information is being displayed.
Refers to the class of interface, which can be one of four:
ip refers to an IP interface
ipmp refers to an IPMP interface
vni refers to a virtual interface
loopback refers to a loopback interface, which is automatically created. Except for the loopback interface, you can manually create the remaining 3 interface classes.
Refers to the status of the interface, which can either be ok, offline, failed, down, or disabled.
The status failed applies to IPMP groups and can refer to a datalink or an IP interface that is down and cannot host traffic. If the IP interface belongs to an IPMP group, then the IPMP interface can continue to receive and send traffic by using other active IP interfaces in the group.
The status down refers to an IP interface that is switched offline by the administrator.
The status disable refers to the IP interface that is unplumbed by using the ipadm disable-if command.
Indicates whether the interface is being used to host traffic, and is set either to yesor no.
Applies only to the IPMP class of interfaces and refers to the underlying interfaces that constitute the IPMP interface or group.
# ipadm show-addr [addrobj]
If you do not specify an address identifier, then address information is provided for all the address identifiers on the system.
The fields in the command output refer to the following:
Specifies the address object whose address is being listed.
Indicates whether the IP address is static, dhcp, or addrconf. The addrconf setting indicates that the address was obtained by using stateless or stateful address configuration.
Describes the address object in its actual active configuration. For a full list of these values, see the ipadm(1M) man page.
Specifies the IP address that is configured over the interface. The address can be IPv4 or IPv6. A tunnel interface will display both local and remote addresses.
For more information about tunnels, see Chapter 6, Configuring IP Tunnels, in Oracle Solaris Administration: IP Services.
# ipadm show-ifprop [-p property] interface
If you do not specify a property, then all the properties and their settings are displayed.
The fields in the command output refer to the following:
Refers to the interface whose information is being displayed.
Refers to the property of the interface. An interface can have several properties.
Refers to the protocol to which the property applies, and which can either be IPv4 or IPv6.
Refers to the allowed permissions of a given property, which can be read only, write only, or both.
Indicates the current setting of the property in active configuration.
Refers to the setting of the property that is reapplied when the system is rebooted.
Indicates the default setting of the specified property.
Refers to a list of values that can be assigned to the specified property. For numeric settings, a range of acceptable values is displayed.
Note - If any field value is unknown, such as when an interface does not support the property whose information is being requested, the setting is displayed as a question mark (?).
# ipadm show-addrprop [-p property,...] [addrobj]
The information that is displayed depends on the options that you use.
If you do not specify a property, then all properties are listed.
If you specify only the property, then that property for all the addresses is displayed.
If you specify only the address object, then the properties of all existing addresses on the system are displayed.
The fields in the command output refer to the following:
Refers to the address object whose properties are being listed.
Refers to the property of the address object. An address object can have several properties.
Refers to the allowed permissions of a given property, which can be read only, write only, or both.
Refers to the actual setting of the property in the present configuration.
Refers to the setting of the property that is reapplied when the system is rebooted.
Indicates the default setting of the specified property.
Refers to a list of settings that can be assigned to the specified property. For numeric settings, a range of acceptable values is displayed.
Example 9-8 Using the ipadm Command to Monitor Interfaces
This set of examples shows the types of information that can be obtained by using the ipadm show-* subcommands. First, general interface information is displayed. Then, address information is provided. Finally, information about a specific property, the MTU of the interface net1, is provided. The examples include tunnel interfaces as well as interfaces that use a customized name.
# ipadm show-if IFNAME CLASS STATE ACTIVE OVER lo0 loopback ok yes -- net0 ip ok yes -- net1 ip ok yes -- tun0 ip ok yes -- # ipadm show-addr ADDROBJ TYPE STATE ADDR lo0/? static ok 127.0.0.1/8 net0/v4 static ok 192.168.84.3/24 tun0/v4tunaddr static ok 173.129.134.1-->173.129.134.2
Note that an address object that is listed 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, which requires that the address object name use the format interface/user-defined-string. For examples of assigning IP addresses, see How to Configure an IP Interface.
# 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 # ipadm show-addrprop net1/v4 ADDROBJ PROPERTY PERM CURRENT PERSISTENT DEFAULT POSSIBLE net1/v4 broadcast r- 192.168.84.255 -- 192.168.84.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 --