Skip Navigation Links | |
Exit Print View | |
Connecting Systems Using Fixed Network Configuration in Oracle Solaris 11.1 Oracle Solaris 11.1 Information Library |
1. Overview of Fixed Network Configuration
2. Configuring a System for the Network
Removing an IP Interface Configuration (ipadm delete-ip)
Disabling an IP Interface Configuration (ipadm disable-ip)
Removing an Interface's Address (ipadm delete-addr)
Setting IP Interface Properties
Setting TCP/IP Protocol Properties
Enabling Packet Forwarding Globally
Implementing Symmetric Routing on Multihomed Hosts
Implementing Traffic Congestion Control
Changing the TCP Receive Buffer Size
Monitoring IP Interfaces and Addresses
Obtaining General Information About IP Interfaces
Obtaining Information About IP Interfaces
Obtaining Information About IP Interface Properties
5. Configuring Wireless Networking on Laptops Running Oracle Solaris
A. Comparison Map: ifconfig and ipadm Commands
Use the ipadm command to monitor and obtain information about IP interfaces and their properties. By itself, the command displays general information about IP interfaces on the system. However, you can also use subcommands to restrict the information that you want to display by using the following syntax:
ipadm show-* [other-arguments] [interface]
To obtain only interface information, use ipadm show-if.
To obtain only address information, use ipadm show-addr.
To obtain information about interface properties, use ipadm show-ifprop.
To obtain information about address properties, use ipadm show-addrprop
This section provides several examples of how to use the ipadm subcommands to obtain interface information. For an explanation of all the fields displayed by the ipadm show-* commands, refer to the ipadm(1M) man page.
Using the ipadm command without accompanying subcommands provides default information about all the system's IP interfaces. For example:
# 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 static ok -- 10.132.146.233/23 net0/v4 dhcp ok -- 10.132.146.234/23 ipmp0 ipmp degraded -- -- ipmp0/v6 static ok -- 2001:db8:1:2::4c08/128 net1 ip failed ipmp0 -- net1/v6 addrconf ok -- fe80::124:4fff:fe58:1831/10 net2 ip ok ipmp0 -- net2/v6 addrconf ok -- fe80::214:4fff:fe58:1832/10 iptun0 ip ok -- -- iptun0/v4 static ok -- 172.16.111.5->172.16.223.75 iptun0/v6 static ok -- fe80::10:5->fe80::223:75 iptun0/v6a static ok -- 2001:db8:1a0:7::10:5->2001:db8:7a82:64::223:75
The sample output provides the following information:
The IP interfaces.
The class of each interface.
The state of each interface.
The status of the interface as being either a “stand alone” IP interface or being an underlying interface for another type of interface configuration. In the example, net1 and net2 are underlying interfaces of ipmp0, as indicated in the UNDER column.
The address objects associated with the interface. Address objects identify a specific IP address. These address objects are listed and indented under the NAME heading to distinguish them from interface names.
The type of IP address, which is indented under the CLASS/TYPE heading and which can be static, dhcp and so on.
The actual addresses listed under the ADDRESS column.
Thus, the ipadm command provides a comprehensive picture of the system's interfaces.
For information about IP interfaces, use the ipadm show-if [interface] subcommand. 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 be one of the following: 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 to eitheryesor no.
Applies only to the IPMP class of interfaces and refers to the underlying interfaces that constitute the IPMP interface or group.
The following is an example of the information that the command provides:
# ipadm show-if IFNAME CLASS STATE ACTIVE OVER lo0 loopback ok yes -- net0 ip ok yes -- net1 ip ok yes -- tun0 ip ok yes --
Use the ipadm show-ifprop [interface] command for information about 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 provided.
The fields in the command output refer to the following:
Refers to the IP interface whose information is being displayed.
Refers to a property of the interface. An interface can have several properties.
Refers to the protocol to which the property applies, which can be either IPv4 or IPv6.
Refers to the allowed permissions of a given property, which can be read only, write only, or both.
Indicates the current value of the property in the active configuration.
Refers to the value of the property that is reapplied when the system is rebooted.
Indicates the default value of the specified property.
Refers to a list of values that can be assigned to the specified property. For numeric values, 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 value is displayed as a question mark (?).
The following is an example of the information that the ipadm show-ifprop subcommand provides:
# 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
For information about IP addresses, use the ipadm show-addr [interface] subcommand. If you do not specify an interface, then the information about all the IP addresses on the system is provided.
The fields in the command output refer to the following:
Specifies the address object whose IP address is being listed.
Indicates whether the IP address is static, dhcp, or addrconf. The addrconf value indicates that the address was obtained by using stateless or stateful address configuration.
Describes the status of the address object in the 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 displays both local and remote addresses.
For more information about tunnels, see Chapter 6, Configuring IP Tunnels, in Configuring and Administering Oracle Solaris 11.1 Networks.
The following is an example of the information that the ipadm show-addr subcommand provides:
# ipadm show-addr ADDROBJ TYPE STATE ADDR lo0/v4 static ok 127.0.0.1/8 net0/v4 static ok 192.168.84.3/24 tun0/v4 static ok 172.16.134.1-->172.16.134.2
If you specify an interface with the command and the interface has multiple addresses, information similar to the following is displayed:
# ipadm show-addr net0 ADDROBJ TYPE STATE ADDR net0/v4 static ok 192.168.84.3/24 net0/v4a static ok 10.0.1.1/24 net0/v4bc static ok 172.16.10.1
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.
For information about IP address properties, use the ipadm show-addrprop [addrobj] subcommand. To list all the properties, omit the addrobj option. To list a single property for all the IP addresses, specify only the property. To list all the properties of a specific address, specify only the addrobj option.
The fields in the command output refer to the following:
Refers to the address object whose properties are being listed.
Refers to a 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 value of the property in the present configuration.
Refers to the value of the property that is reapplied when the system is rebooted.
Indicates the default value of the specified property.
Refers to a list of values that can be assigned to the specified property. For numeric values, a range of acceptable values is displayed.
The following is an example of the information the ipadm show-addrprop subcommand provides:
# 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 --