Skip Navigation Links | |
Exit Print View | |
Oracle Solaris Administration: Network Interfaces and Network Virtualization Oracle Solaris 11 Express 11/10 |
2. NWAM Configuration and Administration (Overview)
3. NWAM Profile Configuration (Tasks)
4. NWAM Profile Administration (Tasks)
5. About the NWAM Graphical User Interface
Part II Administering Single Interfaces
6. Overview of the Networking Stack
7. Datalink Configuration and Administration
8. 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
Comparison Tables: ipadm Command and Other Networking Commands
ifconfig Command Options and ipadm Command Options
ndd Command Options and ipadm Command Options
9. Configuring Wireless Interface Communications on Oracle Solaris
Part III Administering Interface Groups
11. Administering Link Aggregations
Part IV Network Virtualization and Resource Management
15. Introducing Network Virtualization and Resource Control (Overview)
16. Planning for Network Virtualization and Resource Control
17. Configuring Virtual Networks (Tasks)
18. Using Link Protection in Virtualized Environments
19. 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 6, Administering a TCP/IP Network (Tasks), in System Administration Guide: 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 System Administration Guide: 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 interface status. An interface can be in one of the following states: offline, failed, down, and ok.
Refers to other valid combinations of conditions that have been set for the given interface, such as support for broadcast and multicast packets, or whether the interface is a virtual interface.
The field also indicates the type of packets that is supported: IPv4 or IPv6, represented by 4 or 6, respectively. Both settings are displayed if the interface supports both types of packets. Refer to the ipadm(1M) man page for more information about CURRENT.
Specifies the protocol packets that the interface supports when the interface is instantiated after a system reboot, or when the interface is re-enabled by issuing the ipadm enable-if subcommand. The protocol packets can be 4, 6, or s. 4 and 6 refer to IPv4 and IPv6 packets, respectively. s refers to a standby interface in an IPMP configuration.
# 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 7, Configuring IP Tunnels, in System Administration Guide: 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 8-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 STATE CURRENT PERSISTENT lo0 ok -m46-v---- --- subitops1 ok bm4------- -46 net1 ok bm4------- -4- tun0 ok -m46p----- -46 # ipadm show-addr ADDROBJ TYPE STATE ADDR lo0/? static ok 127.0.0.1/8 subitops1/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 --