IPC configuration commands 1

display ipc channel 1

display ipc link· 2

display ipc multicast-group· 3

display ipc node· 4

display ipc packet 5

display ipc performance· 6

display ipc queue· 7

ipc performance enable· 9

reset ipc performance· 9

 

The display commands for the IPC feature display only information about active nodes.

"Local node" refers to the active MPU.

display ipc channel

Syntax

display ipc channel { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays channel information for a node. The node-id argument takes a node number in the range of 0 to 84.

self-node: Displays channel information for the local node.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc channel to display channel information for a node.

Examples

# Display channel information for node 6.

<Sysname> display ipc channel node 6

ChannelID      Description

-----------------------------------------------

14              Prehistorical channel, NO.2

15              Prehistorical channel, NO.6

16              Prehistorical channel, NO.7

19              RPC channel

25              Prehistorical channel, NO.4

26              Prehistorical channel, NO.8

27              FIB4

32              Prehistorical channel, NO.3

33              Prehistorical channel, NO.11

34              Prehistorical channel, NO.9

35              IPC test channel

37              Prehistorical channel, NO.12

43              Prehistorical channel, NO.14

45              Prehistorical channel, NO.5

53              Prehistorical channel, NO.13

62              Prehistorical channel, NO.10

Table 1 Command output

Field	Description
ChannelID	Channel number, which has been predefined and assigned by the system. One channel number corresponds to one module. The display ipc channel command displays the numbers of the current active modules.
Description	Description, which is generated by the internal software of the switch, is used to describe the functions of a channel. For example, "FIB4" indicates that the channel is used for Layer 3 fast forwarding. "Prehistorical channel, NO.2" indicates that no description is defined for the channel, and the channel is the second channel established.

 

display ipc link

Syntax

display ipc link { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays the link status of the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Displays the link status of the local node.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc link to display the link status of the specified node.

Examples

# Display link status of the local node.

<Sysname> display ipc link self-node

Dst-NodeID         LinkStatus

-------------------------------------------

1                   UP

2                   DOWN

The output shows that:

·     The connection between the local node and peer node 1 is up.

·     The connection between the local node and peer node 2 is down.

Table 2 Command output

Field	Description
Dst-NodeID	Number of the peer node.
LinkStatus	Link status: ·     UP—The connection has been established. ·     DOWN—The connection has been terminated.

 

display ipc multicast-group

Syntax

display ipc multicast-group { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays the multicast group status of the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Displays the multicast group status of the local node.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc multicast-group to display multicast group information for the specified node.

Examples

# Display multicast group information for node 6.

<Sysname> display ipc multicast-group node 6

GroupID    Status    ChannelID

----------------------------------

8           INUSE      12

Table 3 Command output

Field	Description
GroupID	Multicast group ID.
Status	Link status: ·     INUSE—The multicast group is in use. ·     DELETE—The multicast group is to be deleted.
ChannelID	Channel number.

 

display ipc node

Syntax

display ipc node [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc node to display node information.

Examples

# Display node information for the switch.

<Sysname> display ipc node

Self node ID: 0

Current active node ID: 0

Table 4 Command output

Field	Description
Self node ID	Number of the local node.
Current active node ID	List of the current active nodes.

 

display ipc packet

Syntax

display ipc packet { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays the packet statistics of the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Displays the packet statistics of the local node.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc packet to display the packet statistics of the specified node.

Examples

# Display the packet statistics of the local node.

<Sysname> display ipc packet self-node

ChannelID Sent-fragments Sent-packets Received-fragments Received-packets

--------------------------------------------------------------------------

11          828              810            819                   810

13          0                0               0                     0

14          5                3               5                     5

15          0                0               0                     0

16          0                0               0                     0

17          50               50             37                    35

19          0                0               0                     0

Table 5 Command output

Field	Description
ChannelID	Channel number.
Sent-fragments	Number of fragments sent.
Sent-packets	Number of packets sent. Whether a packet is fragmented depends on the interface MTU and the packet size in bytes. If the packet size is larger than the MTU, the packet is fragmented. If the packet size is smaller than or equal to the MTU, the packet is sent.
Received-fragments	Number of fragments successfully received.
Received-packets	Number of packets successfully received. If fragments are received on an interface, the system reassembles the fragments and sends a complete packet to the upper layer.

 

display ipc performance

Syntax

display ipc performance { node node-id | self-node } [ channel channel-id ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays the IPC performance statistics of the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Displays the IPC performance statistics of the local node.

channel channel-id: Displays the IPC performance statistics of the specified channel, where the channel-id argument represents the channel number. The channel-id argument is in the range of 0 to 179.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc performance to display IPC performance statistics.

If IPC performance statistics is enabled, the command displays the current IPC performance statistics. If IPC performance statistics is disabled, the command displays the IPC performance statistics collected before IPC performance statistics was disabled.

Related commands: ipc performance enable.

Examples

# Display the IPC performance statistics for node 6.

<Sysname> display ipc performance node 6

Peak: Peak rate (pps)

10Sec: Average rate in the last 10 seconds (pps)

1Min: Average rate in the last 1  minute (pps)

5Min: Average rate in the last 5  minutes (pps)

Total-Data: Total number of data (packets)

 

Statistics for packets sent successfully:

Peak        10Sec         1Min        5Min        Total-Data

------------------------------------------------------------

1            1              1            0           80

Statistics for packets received successfully:

Peak        10Sec         1Min        5Min        Total-Data

------------------------------------------------------------

1            1              1            0           82

Statistics for packets acknowledged:

Peak        10Sec         1Min        5Min        Total-Data

------------------------------------------------------------

1            1              1            0           78

Table 6 Command output

Field	Description
Peak	Peak rate in pps (average rate is measured every 10 seconds, and the greatest average rate is taken as the peak rate).
10Sec	Average rate (in pps) for the past 10 seconds.
1Min	Average rate (in pps) for the past 1 minute.
5Min	Average rate (in pps) for the past 5 minutes.
Total-Data	Total amount of data collected from the time when IPC performance statistics was enabled to the time when this command was executed.

 

display ipc queue

Syntax

display ipc queue { node node-id | self-node } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

node node-id: Displays the sending queue status of the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Displays the sending queue status of the local node.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display ipc queue to display the sending queue status of the specified node.

Examples

# Display the sending queue status of the local node.

<Sysname> display ipc queue self-node

QueueType  QueueID Dst-NodeID   Length  FullTimes   Packet

------------------------------------------------------------

UNICAST     0        0             4096     0            0

UNICAST     1        0             4096     0            0

UNICAST     2        0             4096     0            0

UNICAST     3        0             4096     0            0

UNICAST     0        1             4096     0            0

UNICAST     1        1             4096     0            0

UNICAST     2        1             4096     0            0

UNICAST     3        1             4096     0            0

MULTICAST   0        --            4096     0            0

MULTICAST   1        --            4096     0            0

MULTICAST   2        --            512      0            0

MULTICAST   3        --            512      0            0

MULTICAST   4        --            512      0            0

MULTICAST   5        --            512      0            0

MIXCAST     0        --            2048     0            0

MIXCAST     1        --            2048     0            0

Table 7 Command output

Field	Description
QueueType	Queue type: ·     UNICAST—Unicast queue. ·     MULTICAST—Multicast (including broadcast) queue. ·     MIXCAST—Mixcast queue, which can accommodate unicast, multicast, and broadcast traffic.
QueueID	Queue number.
Dst-NodeID	Peer node number. If no peer node exists, two hyphens (--) are displayed.
Length	Queue length (number of packets that can be buffered).
FullTimes	Number of times the queue was full.
Packet	Total number of packets in the queue.

 

ipc performance enable

Syntax

ipc performance enable { node node-id | self-node } [ channel channel-id ]

undo ipc performance enable [ node node-id | self-node ] [ channel channel-id ]

View

User view

Default level

1: Monitor level

Parameters

node node-id: Enables IPC performance statistics for the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Enables IPC performance statistics for the local node.

channel channel-id: Enables IPC performance statistics for the specified channel, where the channel-id argument represents the channel number. The channel-id argument is in the range of 0 to 179.

Description

Use ipc performance enable to enable IPC performance statistics.

Use undo ipc performance to disable IPC performance statistics.

By default, IPC performance statistics is disabled.

After IPC performance statistics is disabled, the statistics data does not change. The display ipc performance command displays the statistics collected before IPC performance statistics was disabled.

Examples

# Enable IPC performance statistics for channel 18 on node 6.

<Sysname> ipc performance enable node 6 channel 18

reset ipc performance

Syntax

reset ipc performance [ node node-id | self-node ] [ channel channel-id ]

View

User view

Default level

1: Monitor level

Parameters

node node-id: Clears the IPC performance statistics for the specified node, where the node-id argument represents the number of the specified node. The node-id argument is in the range of 0 to 84.

self-node: Clears the IPC performance statistics of the local node.

channel channel-id: Clears the IPC performance statistics for the specified channel, where channel-id represents the channel number. The channel-id argument is in the range of 0 to 179.

Description

Use reset ipc performance to clear IPC performance statistics.

Examples

# Clear the IPC performance statistics for channel 18 on node 6.

<Sysname> reset ipc performance node 6 channel 18