JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Administration: Network Interfaces and Network Virtualization     Oracle Solaris 11 Express 11/10
search filter icon
search icon

Document Information

Preface

Part I Network Auto-Magic

1.  Introduction to NWAM

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

The ipadm Command

Configuring IP Interfaces

How to Configure an IP Interface

Setting IP Address Properties

How to Set the Property of an IP Address

Setting IP Interface Properties

Enabling Packet Forwarding

Administering Protocol Properties

Setting TCP/IP Properties

How to Restrict a Port's Access to root User Only

How to Implement Symmetric Routing on Multihomed Hosts

Monitoring IP Interfaces and Addresses

How to Obtain Information About Network Interfaces

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

10.  Administering Bridges

11.  Administering Link Aggregations

12.  Administering VLANs

13.  Introducing IPMP

14.  Administering IPMP

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

20.  Monitoring Network Traffic and Resource Usage

Glossary

Index

Monitoring IP Interfaces and Addresses

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]

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.


How to Obtain Information About Network Interfaces

This procedure describes how to display information about an interface's general status, address information, and IP properties.

  1. Become an administrator.

    For more information, see How to Obtain Administrative Rights in System Administration Guide: Security Services.

  2. To obtain status information about an interface, type the following command:
    # 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:

    IFNAME

    Refers to the interface whose information is being displayed.

    STATE

    Refers to the interface status. An interface can be in one of the following states: offline, failed, down, and ok.

    CURRENT

    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.

    PERSISTENT

    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.

  3. To obtain address information for the interface, type the following command:
    # 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:

    ADDROBJ

    Specifies the address object whose address is being listed.

    TYPE

    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.

    STATE

    Describes the address object in its actual active configuration. For a full list of these values, see the ipadm(1M) man page.

    ADDR

    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.

  4. To obtain information about interface properties, type the following command:
    # 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:

    IFNAME

    Refers to the interface whose information is being displayed.

    PROPERTY

    Refers to the property of the interface. An interface can have several properties.

    PROTO

    Refers to the protocol to which the property applies, and which can either be IPv4 or IPv6.

    PERM

    Refers to the allowed permissions of a given property, which can be read only, write only, or both.

    CURRENT

    Indicates the current setting of the property in active configuration.

    PERSISTENT

    Refers to the setting of the property that is reapplied when the system is rebooted.

    DEFAULT

    Indicates the default setting of the specified property.

    POSSIBLE

    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 (?).


  5. To obtain information about an address property, type the following command:
    # 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:

    ADDROBJ

    Refers to the address object whose properties are being listed.

    PROPERTY

    Refers to the property of the address object. An address object can have several properties.

    PERM

    Refers to the allowed permissions of a given property, which can be read only, write only, or both.

    CURRENT

    Refers to the actual setting of the property in the present configuration.

    PERSISTENT

    Refers to the setting of the property that is reapplied when the system is rebooted.

    DEFAULT

    Indicates the default setting of the specified property.

    POSSIBLE

    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           --