06-IP Address-IP Performance Commands

Download


Chapter 1  IP Address Configuration Commands

1.1  IP Address Configuration Commands

1.1.1  display ip interface

Syntax

display ip interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Specifies an interface by its type and number.

Description

Use the display ip interface command to display information about a specified or all Layer 3 interfaces.

If no argument is specified, information about all Layer 3 interfaces is displayed.

Examples

# Display information about VLAN-interface 1.

<Sysname> display ip interface Vlan-interface 1

Vlan-interface1 current state :UP

Line protocol current state :UP

Internet Address is 192.168.0.39/24 Primary

Broadcast address : 192.168.0.255

The Maximum Transmit Unit : 1500 bytes

IP packets input number: 9678, bytes: 475001, multicasts: 7

IP packets output number: 8622, bytes: 391084, multicasts: 0

TTL invalid packet number:         0

ICMP packet input number:          0

  Echo reply:                      0

  Unreachable:                     0

  Source quench:                   0

  Routing redirect:                0

  Echo request:                    0

  Router advert:                   0

  Router solicit:                  0

  Time exceed:                     0

  IP header bad:                   0

  Timestamp request:               0

  Timestamp reply:                 0

  Information request:             0

  Information reply:               0

  Netmask request:                 0

  Netmask reply:                   0

  Unknown type:                    0

Table 1-1 Description on the fields of the display ip interface command

Field

Description

Vlan-interface1 current state

Current physical state of VLAN-interface 1

Line protocol current state

Current state of the link layer protocol

Internet Address

IP address of the interface

Broadcast address

Directed broadcast address of the subnet attached to the interface

The Maximum Transmit Unit

Maximum transmission unit on the interface

IP packets input number: 9678, bytes: 475001, multicasts: 7

IP packets output number: 8622, bytes: 391084, multicasts: 0

Total number of packets, bytes, and multicast packets forwarded and received on the interface

TTL invalid packet number

Number of received invalid TTL packets

ICMP packet input number:          0

    Echo reply:                                0

    Unreachable:                            0

    Source quench:                        0

    Routing redirect:                       0

    Echo request:                            0

    Router advert:                           0

    Router solicit:                            0

    Time exceed:                            0

    IP header bad:                          0

    Timestamp request:                  0

    Timestamp reply:                      0

    Information request:                  0

    Information reply:                      0

    Netmask request:                      0

    Netmask reply:                          0

    Unknown type:                          0

Total number of received ICMP packets, including:

Echo reply packet, unreachable packet, source quench packet, routing redirect packet, Echo request packet, router advert packet, router solicit packet, time exceed packet, IP header bad packet, timestamp request packet, timestamp  reply packet, information request packet, information reply packet, netmask request packet, netmask reply packet, and unknown types of packets.

 

1.1.2  display ip interface brief

Syntax

display ip interface brief [ interface-type [ interface-number ] ]

View

Any view

Parameters

interface-type: Interface type.

interface-number: Interface number.

Description

Use the display ip interface brief command to display brief information about a specified or all Layer 3 interfaces.

With no argument included, the command displays information about all layer 3 interfaces; with only the interface type specified, it displays information about all layer 3 interfaces of the specified type; with both the interface type and interface number specified, it displays information about the specified interface.

Related commands: display ip interface.

Examples

# Display brief information about VLAN-interface 1.

<Sysname> display ip interface brief vlan-interface 1

*down: administratively down

(l): loopback

(s): spoofing

 Interface               IP Address     Physical Protocol     Description

 Vlan-interface1         192.168.0.39    up       up           Vlan-inte...

Table 1-2 Description on the fields of the display ip interface brief command

Field

Description

*down

The interface is administratively shut down with the shutdown command.

(s)

Spoofing attribute of the interface. It indicates that the interface whose link layer protocol is displayed up may have no such a link present or the link is set up only on demand.

Interface

Interface name

IP Address

IP address of the interface (If no IP address is configured, “unassigned” is displayed.)

Physical

Physical state of the interface

Protocol

Link layer protocol state of the interface

Description

Interface description information.

If the description has no more than 12 characters, the whole description can be displayed. If it has more than 12 characters, only the first nine characters are displayed.

 

1.1.3  ip address

Syntax

ip address ip-address { mask | mask-length }

undo ip address [ ip-address { mask | mask-length } ]

View

VLAN interface view, loopback interface view

Parameters

ip-address: IP address, in dotted decimal notation.

mask: Subnet mask, in dotted decimal notation.

mask-length: Subnet mask length, the number of consecutive ones in the mask. It is in the range of 0 to 32.

Description

Use the ip address command to specify an IP address and mask for a VLAN or loopback interface.

Use the undo ip address command to remove an IP address and mask of a VLAN or loopback interface.

By default, no IP address is configured for VLAN or loopback interface.

 

&  Note:

l      A newly specified IP address overwrites the previous one if there is any.

l      The IP address of a VLAN interface must not be in the same network segment as that of a loopback interface on a device.

 

Related commands: display ip interface.

Examples

# Assign the IP address 129.12.0.1 to VLAN interface 1 with subnet mask 255.255.255.0.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] interface Vlan-interface 1

[Sysname-Vlan-interface1] ip address 129.12.0.1 255.255.255.0


Chapter 2  IP Performance Configuration Commands

2.1  IP Performance Configuration Commands

2.1.1  display fib

Syntax

display fib

View

Any view

Parameters

None

Description

Use the display fib command to display all forwarding information base (FIB) information.

Examples

# Display all FIB information.

<Sysname> display fib

Flag:

  U:Usable   G:Gateway    H:Host       B:Blackhole  D:Dynamic    S:Static

  R:Reject   E:Equal cost multi-path   L:Generated by ARP or ESIS     Destination/Mask   Nexthop         Flag TimeStamp     Interface

10.153.17.0/24     10.153.17.99    U    t[37]          Vlan-interface1

10.153.18.88/32    127.0.0.1       GHU  t[37]          InLoopBack0

10.153.18.0/24     10.153.18.88    U    t[37]          LoopBack0

10.153.17.99/32    127.0.0.1       GHU  t[37]          InLoopBack0

127.0.0.0/8        127.0.0.1       U    t[33]          InLoopBack0

Table 2-1 Description on the fields of the display fib command

Field

Description

Flag

Flags:

U: A route is up and available.

G: Gateway route

H: Local host route

B: Blackhole route

D: Dynamic route

S: Static route

R: Rejected route

E: Multi-path equal-cost route

L: Route generated by ARP or ESIS

Destination/Mask

Destination address/mask length

Nexthop

Next hop address

TimeStamp

Timestamp

Interface

Forwarding interface

 

2.1.2  display fib ip-address

Syntax

display fib ip-address1 [ { mask1 | mask-length1 } [ ip-address2 { mask2 | mask-length2 } | longer ] | longer ]

View

Any view

Parameters

ip-address1, ip-address2: Destination IP addresses, in dotted decimal notation. ip-address1 and ip-address2 together define an address range. The FIB entries in this address range will be displayed.

mask1, mask2: Subnet masks, in dotted decimal notation.

mask-length1, mask-length2: Length of the subnet masks, the number of consecutive ones in the masks, in the range of 0 to 32.

longer: Displays the FIB entries matching the specified address/mask and having masks longer than or equal to the specified mask. If no masks are specified, FIB entries that match the natural network address and have the masks longer than or equal to the natural mask will be displayed.

Description

Use the display fib ip-address command to view the FIB entries matching the specified destination IP address.

If no mask or mask length is specified, the FIB entry that matches the destination IP address and has the longest mask will be displayed; if the mask is specified, the FIB entry that exactly matches the specified destination IP address and mask will be displayed.

Examples

# Display FIB entry information which matches destination 12.158.10.0 and has a mask length no less than eight.

<Sysname> display fib 12.158.10.0 longer

  Route Entry Count: 1

Flag:

  U:Usable   G:Gateway    H:Host       B:Blackhole  D:Dynamic    S:Static

  R:Reject   E:Equal cost multi-path   L:Generated by ARP or ESIS

Destination/Mask   Nexthop         Flag TimeStamp     Interface

12.158.10.0/24     12.158.10.1     U    t[85391]      Vlan-interface10

# Display FIB entry information which has a destination in the range of 12.158.10.0/24 to 12.158.10.6/24 and has a mask length of 24.

<Sysname> display fib 12.158.10.0 255.255.255.0 12.158.10.6 255.255.255.0

  Route Entry Count: 1

Flag:

  U:Usable   G:Gateway    H:Host       B:Blackhole  D:Dynamic    S:Static

  R:Reject   E:Equal cost multi-path   L:Generated by ARP or ESIS

Destination/Mask   Nexthop         Flag TimeStamp     Interface

12.158.10.0/24     12.158.10.1     U    t[85391]      Vlan-interface10

For details about the displayed information, see Table 2-1.

2.1.3  display fib acl

Syntax

display fib acl acl-number

View

Any view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the display fib acl command to display the FIB entries matching a specific ACL. For ACL, refer to the part discussing ACL in this manual.

Examples

# Configure and display ACL 2001.

<Sysname> system-view

System View: return to User View with Ctrl+Z.

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 211.71.75.0 0.0.0.255

[Sysname-acl-basic-2001] display acl 2001

Basic ACL  2001, 1 rule

Acl's step is 1

 rule 0 permit source 211.71.75.0 0.0.0.255

# Display the FIB entries filtered by ACL 2001.

<Sysname> display fib acl 2001

Route Entry matched by access-list 2001

  Summary Counts :1

Flag:

  U:Usable   G:Gateway    H:Host       B:Blackhole  D:Dynamic    S:Static

  R:Reject   E:Equal cost multi-path   L:Generated by ARP or ESIS

Destination/Mask   Nexthop         Flag TimeStamp     Interface

211.71.75.0/24     1.1.1.2         GSU  t[250763]     Vlan-interface2

For details about the displayed information, see Table 2-1.

2.1.4  display fib |

Syntax

display fib | { begin | exclude | include } regular-expression

View

Any view

Parameters

|: Uses a regular expression to match FIB entries. For detailed information about regular expression, refer to Configuration File Management Command.

begin: Displays a specific FIB entry and all the FIB entries following it. The specific FIB entry is the first entry that matches the specified regular expression.

exclude: Displays the FIB entries that do not match the specified regular expression.

include: Displays the FIB entries that match the specified regular expression.

regular-expression: A case-sensitive character string.

Description

Use the display fib | command to display the FIB entries filtered by the specified regular expression.

Examples

# Display the entries starting from the first one containing the string 169.254.0.0.

<Sysname> display fib | begin 169.254.0.0

169.254.0.0/16   2.1.1.1     U       t[0]            Vlan-interface1

2.0.0.0/16       2.1.1.1     U       t[0]            Vlan-interface1

For details about the displayed information, see Table 2-1.

2.1.5  display fib statistics

Syntax

display fib statistics

View

Any view

Parameters

None

Description

Use the display fib statistics command to display the total number of FIB entries.

Examples

# Display the total number of FIB entries.

<Sysname> display fib statistics

Route Entry Count : 8

2.1.6  display icmp statistics

Syntax

display icmp statistics

View

Any view

Parameters

None

Description

Use the display icmp statistics command to display the statistics about ICMP packets.

Related commands: display ip interface, reset ip statistics.

Examples

# Display the statistics about ICMP packets.

<Sysname> display icmp statistics

  Input: bad formats   0                   bad checksum            0

         echo          5                   destination unreachable 0

         source quench 0                   redirects               0

         echo reply    10                  parameter problem       0

         timestamp     0                   information request     0

         mask requests 0                   mask replies            0

         time exceeded 0

  Output:echo          10                  destination unreachable 0

         source quench 0                   redirects               0

         echo reply    5                   parameter problem       0

         timestamp     0                   information reply     0

         mask requests 0                   mask replies            0

         time exceeded 0

Table 2-2 Description on the fields of the display icmp statistics command

Field

Description

Input:

bad formats

Number of received wrong format packets

bad checksum

Number of received wrong checksum packets

echo

Number of received echo packets

destination unreachable

Number of received destination unreachable packets

source quench

Number of received source quench packets

redirects

Number of received redirection packets

echo reply

Number of received replies

parameter problem

Number of received parameter problem packets

timestamp

Number of received time stamp packets

information request

Number of received information request packets

mask requests

Number of received mask requests

mask replies

Number of received mask replies

time exceeded

Number of received expiration packets

Output:

echo

Number of sent echo packets

destination unreachable

Number of sent destination unreachable packets

source quench

Number of sent source quench packets

redirects

Number of sent redirection packets

echo reply

Number of sent replies

parameter problem

Number of sent parameter problem packets

timestamp

Number of sent time stamp packets

information reply

Number of sent information reply packets

mask requests

Number of sent mask requests

mask replies

Number of sent mask replies

time exceeded

Number of sent expiration packets

 

2.1.7  display ip socket

Syntax

display ip socket [ socktype sock-type ] [ task-id socket-id ]

View

Any view

Parameters

socktype sock-type: Displays the socket information of this type. The sock type is in the range 1 to 3, corresponding to TCP, UDP and raw IP respectively.

task-id: ID of a task, with the value ranging from 1 to 100.

socket-id: ID of a socket, with the value ranging from 0 to 3072.

Description

Use the display ip socket command to display socket information.

Examples

# Display the information about the socket of the TCP type.

<Sysname> display ip socket socktype 1

SOCK_STREAM:

Task = VTYD(18), socketid = 1, Proto = 6,

LA = 0.0.0.0:23, FA = 0.0.0.0:0,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_ACCEPTCONN SO_KEEPALIVE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_PRIV SS_ASYNC

 

Task = VTYD(18), socketid = 2, Proto = 6,

LA = 10.153.17.99:23, FA = 10.153.17.56:1161,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_KEEPALIVE SO_OOBINLINE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_ISCONNECTED SS_PRIV SS_ASYNC

 

Task = VTYD(18), socketid = 3, Proto = 6,

LA = 10.153.17.99:23, FA = 10.153.17.82:1121,

sndbuf = 8192, rcvbuf = 8192, sb_cc = 0, rb_cc = 0,

socket option = SO_KEEPALIVE SO_OOBINLINE SO_SENDVPNID SO_SETKEEPALIVE,

socket state = SS_ISCONNECTED SS_PRIV SS_ASYNC

Table 2-3 Description on the fields of the display ip socket command

Field

Description

SOCK_STREAM

Indicates the socket type is TCP

SOCK_DGRAM

Indicates the socket type is UDP

SOCK_RAW

Indicates the socket type is raw IP

Task

Task ID

socketid

Socket ID

Proto

Protocol number used by the socket

sndbuf

Sending buffer size of the socket

rcvbuf

Receiving buffer size of the socket

sb_cc

Current data size in the sending buffer. The value makes sense only for the socket of TCP type, because only TCP is able to cache data.

rb_cc

Current data size in the receiving buffer

socket option

Option of a socket

socket state

State of a socket

 

2.1.8  display ip statistics

Syntax

display ip statistics

View

Any view

Parameters

None

Description

Use the display ip statistics command to display the statistics about IP packets.

Related commands: display ip interface, reset ip statistics.

Examples

# Display the statistics about IP packets.

<Sysname> display ip statistics

  Input:   sum            7120             local             112

           bad protocol   0                bad format        0

           bad checksum   0                bad options       0

  Output:  forwarding     0                local             27

           dropped        0                no route          2

           compress fails 0

  Fragment:input          0                output            0

           dropped        0

           fragmented     0                couldn't fragment 0

  Reassembling:sum        0                timeouts          0

Table 2-4 Description on the fields of the display ip statistics command

Field

Description

Input:

sum

Total number of packets received

local

Total number of packets with destination being local

bad protocol

Total number of unknown protocol packets.

Unknown protocol packets are destined to the local device, but the upper layer protocol specified in their IP header cannot be processed by the device. (For example, if a switch is not enabled with the Layer 3 multicast function, it considers IGMP packets as unknown protocol packets.)

bad format

Total number of packets with incorrect header format that contains a wrong version, or has a header length less than 20 bytes.

bad checksum

Total number of packets with incorrect checksum

bad options